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From the Editor 


The big news this month is that R&D Publications, the company that founded 
and published Windows/DOS Developer's Journal was acquired by Miller Free¬ 
man, publishers of Dr. Dobb's Journal, Software Development, Unix Review, and 
many others. Although it's too soon to say precisely what the acquisition will 
mean to Windows/DOS, in the short term you will not see any sudden change: 
all of the staff remains in place and I will continue to serve as Senior Editor. In 
the longer term, I hope there will be a host of benefits that contribute to our 
mission of putting relevant, advanced technical information in your hands 
each month. ♦♦ A big change of this kind is a chance to look backward as 
well as forward. Robert Ward will no longer be publisher of this magazine, 
having relinquished most of his many roles (except that of editor of SysAdmin) 
as of the time of the sale. Four and a half years ago, Robert signed a contract 
with a completely untried editor (on paper, I think I looked like a rather dodgy 
choice at best) and started turning over his newest magazine's editing to me. 
R&D stuck with the magazine through a very difficult startup period, including 
a name change that was tantamount to starting over, and it was only after a 
lot of patience and hard work that the investment began to pay off. I don't 
know how well or poorly the magazine would have fared without me, but I 
do know I would have missed my big chance if Robert had not decided to 
give me a try. I am better off for having known Robert, and will always be 
grateful for the opportunity he provided me. I wish Robert and Donna the 
very best as they embark on a life that does not revolve around a monthly 
deadline. ♦♦ Our new publisher is Peter Westerman, who also is the publish¬ 
er for Microsoft Systems Journal and OS/2 Developer, among others. Probably 
anything I say about him at this early stage could be seen as buttering up, but 
I will nevertheless say that I expect he will be a catalyst for positive changes, 
not all of which will be visible to readers. I believe he will help us accomplish 
things our limited resources made difficult in the past. ♦♦ Of course, I gener¬ 
ally reserve my buttering up efforts for the most important folks, namely read¬ 
ers. All of the chaos of the transition should begin to settle down soon, and I 
hope our level of service will not suffer during the transition. We have to do 
our best to leverage the advantages that a larger publisher brings without los¬ 
ing the best features of being a small publisher. We certainly cannot afford to 
pay any less attention to readers now, and I trust you will not wait long to hol¬ 
ler if we start down the wrong path. 


Ron Burk 

Editor 

CIS: 70302,2566; Internet: ronb@rdpub.cow (“...iuunetirdpubironb") 
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bility of referencing datat by value or pointer. 
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A Windows Import Resolver 

Mike Stefanik 


Visual C++ vl .5 
e [i]'i1—1 Borland C++ v4.5 
Symantec C++ v6.1 
Watcom C++ vl 0.0 


Virtually every Windows application depends on DLLs. From the Windows 
API itself to printer or screen drivers, most Windows code of general utility is 
implemented as some kind of DLL. An application can access external DLLs 
explicitly, by calling LoadLibraryO to load and obtain a handle to a specific DLL 
and then calling GetProcAddressO to locate the address of specific functions in 
that DLL. However, the typical Windows application accesses most of its DLLs 
implicitly. If you link your .exe with comdlg.lib, for example, you are not really 
linking the common dialog common dialog code into your application. Instead, 
since commdlg.lib is just an import library (basically, a description of a DLL and 
the functions it contains), linking with comdlg.lib places information in your 
.exe that allows Windows to make the equivalent calls to LoadLibraryO and 
GetProcAddressO on your behalf. Since any DLL to which you implicitly link 
might itself link implicitly to other DLLs, your .exe could depend on a number 
of DLLs you did not know about. 

There are a number of reasons why it could be useful to see the complete 
list of DLLs that a Windows .exe implicitly depends on. If you plan to distribute 
the .exe to others, for example, you might want to verify that you have 
included all the necessary libraries - or you might want to have an installation 
program verify that required system DLLs are already present. Another reason 
to be aware of the complete list of DLL dependencies is to improve your 
application's load time. If your application implicitly links to several dozen DLLs, 
Windows has to load and link those DLLs into the application when it starts up, 
possibly resulting in sluggish startup times. You may be able to improve startup 
time by switching to explicit rather than implicit linking for some of those DLLs 
(such as comdlg.dll, shell.dll, msystem.dll, etc.). Ultimately, the same amount 
of time will be consumed in linking, but the sooner your main window appears 
(which cannot happen until all implicitly linked DLLs are loaded and linked), the 
sooner the user will think your application has actually started to function. 


Mike Stefanik is a developer for Information Management Systems, a Sherman Oaks, 
California company that specializes in migrating legacy applications to Windows and 
UNIX. He can be reached via the Internet at mstefan@earthlink.net or on CompuServe 
at 72202,1427. 
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The Professional Edition adds 
a VBA-macro editor and debugger that you can make 
part of your application. 

Skip the spring training. Just get in the game. 

Smarter Components from Sax: 

Sax Basic Engine: Standard $149; Professional $495. 
Sax Comm Objects: Standard $149; Professional $495. 
Sax Setup Wizard: $149. 
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a 30-day money-back guarantee. 
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Listing 1 module.c — Source code for resolving imported DLLs 


// compile with STRICT defined and large memory model, 
//include <windows.h> 

//include <string.h> 

#include <malloc.h> 

//include <io.h> 

//include <direct.h> 

//include "module.h" 

int GetlmportFileName(LPSTR. LPSTR. LPSTR, int); 

BOOL InModuleList(LPMODULE, LPSTR); 

BOOL AppendHoduleList(LPMODULE *. LPSTR, LPSTR. BOOL); 


//define EMAGIC 


0x5A4D 


typedef 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
WORD 
} EXEHDR 


struct tagEXEHDR 
wSignature; // 
wExtraBytes; // 
wPages; // 
wRelocItems; // 
wHeaderSize; // 


wMinAUoc; 
wMaxAlloc; 
wlnitSS; 
wlnitSP; 
wCheckSum; 
wlnitlP; 
wlnitCS; 
wRelocTable; // 
wOyerlay: // 


{ 

executable signature 

number of bytes in last page 

number of pages in file 

number of entries in relocation table 

size of header, in paragraphs 

minimum allocation 

maximum allocation 

initial SS value 

initial SP value 

checksum 

initial IP value 
initial CS value 
offset to relocation table 
overlay number 


//def ine NEMAGIC 
//define NEHDROFF 


0x454E 

0x3C 





Order your 
evaluation 
package 
today! 

Call now: 800-986-6578 

WIBU-KEY - The ultimate Copy Protection System! 

New: Remote Programming of WIBU-BOXes via Phone, 
FAX or mail - new chances for more sales! 

Available for LPT, COM, ADB, (E)ISA slots and PCMCIA 
Protection for DOS, Windows and networks without 
requiring source code modification We are 

Win32s, Windows™NT, OS/2®, MacOS looking for 

international 


WIBU 

ligh Quality in 


distributors j 


'W 


SYSTEMS 


WIBU-SYSTEMS GmbH 
Rueppurrer Strasse 54 
D-76137 Karlsruhe, Germany 
Phone: +49-721-93172-0 
FAX: +49-721-93172-22 



* EUROPEAN SOFTWARE 

CONNECTION 

1617 St. Andrews Drive, Lawrence, KS 66047 
Phone: (913) 832-2070, FAX: (913) 832-8787 


typedef struct tagNEWEXEHDR { 

WORD wSignature; // new executable signature 

BYTE bVersion; // linker version number 

BYTE bRevision; // linker revision number 

WORD wEntryTable; // relative offset to entry table 

WORD wEntryTableSize; // size of entry table 
DWORD dwCheckSum; // CRC checksum of file 
WORD wFlags; // flags 

WORD wAutoDS; // automatic data segment 

WORD wHeapSize; // size of local heap 

WORD wStackSize; // size of stack 

WORD wlnitlP; // initial IP value 

WORD wlnitCS; // initial CS value 

WORD wlnitSP; // initial SP value 

WORD wlnitSS; // initial SS value 

WORD wSegmentTableSize; // segments in segment table 
WORD wModuleTableSize; // entries in module table 
WORD wNonResNameTableSize; // non-resident name table size 
WORD wSegmentTable; // offset to segment table 
WORD wResourceTable; // offset to resource table 
WORD wResNameTable; // offset to resident name table 
WORD wHoduleTable; // offset to module ref. table 

WORD wlmportTable; // offset to import name table 

WORD wNonResNameTable; // offset to non-resident name table 
WORD wMovable; // number of movable entry points 
WORD wAlignment; // alignment shift for segment data 
WORD wResourceSeg; // resource segment count 
// target operating system 
// other EXE flags 
// relative offset to gangload area 
// size of gangload area 
// minimum code swap size 
// expected version number for Windows 


BYTE bExeType; 

BYTE bOtherFlags; 
WORD wGangLoad; 

WORD wGangLoadSize; 
WORD wMinSwapSize; 
WORD wExpVersion; 
NEWEXEHDR; 


//if defined!_BORLANDC_) 

^include <dir.h> 

//define _getcwd getcwd 
//define _access access 
//el if defined(_WATCOMC__) 

//define _getcwd getcwd 
//endi f 

BOOL GetlmportModules(LPMODULE *ppModuleList, 

LPSTR pszFileName, MODERRPROC ShowError) 

{ 

HFILE hf; 

EXEHDR oldhdr; 

NEWEXEHDR newhdr; 

WORD wNewExeOffset, wModOffset, wModules; 

BYTE cbNameLen: 

LONG ITablePos, INamePos; 
char szModuleName[9], szModulePath[128]; 
char szModuleFi1e[128]; 
char *p; 

if ((hf = _lopen(pszFileName, READ)) == HFILE_ERROR) { 
ShowError(E_NFILE, pszFileName); 
return FALSE; 

} 

1strcpyn(szModulePath, pszFi1eName, 
sizeof(szModulePath)); 

if ((p = strrchrtszModulePath, '\\')) != NULL) 

*(p+l) = ’\0’; 
else { 

_getcwd(szModulePath, sizeof(szModulePath)-1); 
if (szModulePath[lstrlen(szModulePath)-l] != ’W) 
IstrcattszModulePath, "\\"); 

} 

// Read in the old-style executable header block; 
if (_lread(hf, Aoldhdr, sizeof(EXEHDR)) != 
sizeof(EXEHDR)) { 

Jclose(hf); 
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This article explains how to read 
through a Windows executable and 
determine which libraries are re¬ 
quired for the program to load. I sup¬ 
ply a single function, Get Import - 
Modules(), that creates a linked list of 
imported module names for a given 
executable. As it locates the DLLs im¬ 
plicitly linked to the given executable, 
it recursively scans those DLLs for 
their dependencies, until the com¬ 
plete list is assembled. The source 
code for GetlmportModulesO is in mod¬ 
ules (Listing 1) and the interface to 
this function is in module, h (Listing 2). 
The code disk contains (see Table of 
Contents for availability) a sample 
program, import.exe, that uses Getlm¬ 
portModulesO to display the list of im¬ 
ported modules in a listbox. The 
code disk also contains bldimp.bat, 
which contains commands to com¬ 
pile and link the code with Borland 
C++ v4.5, Visual C++ vl .5, Symantec 
C++ v7.0, or Watcom C++ vl 0.0. 


Figure 1 Anatomy of module information in a .exe 
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Setup Pro brings you the features that 
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Put our expert to 
work for you! 
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the dark ages 
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Expert to work and charge into the 21st 
century! With the Setup Expert, building a 
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your files are compressed and your disks 
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A standard, professional interface. 

The first thing your customer sees, is the 
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Setup Pro's standard, 
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windows with use¬ 
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Davis Publishing, and the US Army Corps 
of Engineers. Why take chances? 
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Listing 1 continued 

ShowErrortEJIMAGIC, pszFi 1 eName ) ; 

ShowError(E_CORRUPT, pszFi 1 eName); 

return FALSE; 

} 

return FALSE; 

} 

// Verify that this is an executable file 

// Get the module name for this executable 

if (oldhdr.wSignature != EMAGIC) { 

llseekthf, (LONGKwNewExeOffset+newhdr.wResNameTable), 0); 

lclose(hf); 

lreadthf, ScbNameLen, sizeof(BYTE)); 

ShowErrortE NMAGIC, pszFi1eName); 

lreadthf, szModuleName, (int)cbNameLen); 

return FALSE; 

szModuleName[cbNameLen] = ' \0 ’; 

1 

AppendModuleList ( ppModuleList, szModuleName, 


pszFileName, FALSE); 

// Verify that this is a Windows executable 
if (oldhdr.wRelocTable < 0x40) { 

// Calculate the absolute offset of the module table 

lclose(hf); 

ITablePos = (LONG)twNewExeOffset + newhdr.wModuleTable); 

ShowError(E_OLDAPP, pszFileName); 
return FALSE; 

wModules = newhdr.wModuleTableSize; 

} 

while (wModules > 0) { 


// Seek to the next entry in the module table 

// Read the offset to the NE header block 

llseekthf, ITablePos, 0); 

_llseek(hf, (LONG)NEHDROFF, 0); 
lreadthf, AwNewExeOffset, sizeof(WORD) ) ; 

Jreadthf, iwModOffset, sizeof (WORD) ) ; 


// Calculate offset to the module name 

// Read in the NE header block 

INamePos = (LONG)twNewExeOffset + 

llseekthf, (LONG)wNewExeOffset, 0); 

newhdr.wImportTable + wModOffset); 

if ( lreadthf, Anewhdr, sizeof(NEWEXEHDR) ) != 

Jlseekthf, INamePos, 0); 

si zeof ( NEWEXEHDR) ) { 
lclose(hf); 

// Read module name 

ShowErrortE CORRUPT, pszFileName); 

Jreadthf, AcbNameLen, sizeof(BYTE) ) ; 

return FALSE; 

lreadthf, szModuleName, (int)cbNameLen); 

} 

szModuleName[cbNameLen] = '\0'; 

// Check the NE signature 

// Check if module is in table and add if needed 

if (newhdr.wSignature != NEMAGIC) { 

if (! InModuleList(*ppModuleList. szModuleName)) { 

Jclosethf); 

if (IGetlmportFileNametszModuleName, szModulePath, 


Locating the New 
Executable Header 

The key to understanding how 
GetlmportModulesO works is the for¬ 
mat of the Windows executable file. 
Figure 1 provides an overview of the 
portions of the .exe format that 
GetlmportModulesO must trace 
through. A Windows .exe begins with 
a header that is identical to the be¬ 
ginning of a DOS .exe. Positioned af¬ 
ter the DOS header is a small stub 
program, which by default simply re¬ 
ports that the program requires Mi¬ 
crosoft Windows and terminates. If 
you try to execute the Windows . exe 
under DOS, the DOS loader treats it 
as any other DOS program and ends 
up loading and executing this stub 
program. The Windows loader, on 
the other hand, skips past the DOS 
portion of the .exe to locate the so- 
called 'New Executable' or NE 
header. In other words, a Windows 
.exe is more or less like a normal 
DOS .exe, but with an entirely new 
style of executable embedded in it. 
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DOS or 
Windows!® 


Whether creating fantastic virtual realities or complex 
client/server applications, the last thing you need is an 
antiquated editing tool that is inadequate, inflexible 
and slow. In order for you to work effortlessly 
through your daily development tasks, j 

an editing environment which is cus- . j 
tomizable, intuitive, and powerful is a T" , 

must : anything less ends up being an » «4 

obstacle. » q 

i % 

Multi-Edit represents the next genera- ^ jw, 

tion of program editors and is the 

answer to today's (and tomorrow's) g| 

development needs. Multi-Edit is . """""ij 

extremely easy to use, richly featured, 
and offers seamless integration — m ii ,-. . < P— 

and lull leconfigurabilitv - ^ , 

an editor which works 
the way you work! 
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"on the fly" without touching any macros or .ini files. The 
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and Modula-2. Language sensitive syntax highlighting 
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rently supported, we'll write support for it free of charge! 

For today's developers. Workgroup support is no longer a 
luxury, it is a requir ement. Multi-Edit addresses this by pro¬ 
viding unparalleled integration with most VCS systems such 
as PVCS, TLIB, Source Safe, Versions, CA-LCM and MKS- 
RCS. Of course, complete network support including file 
locking, multi-user configuration, and MAPI/MS-Mai! inte¬ 
gration is also included. And when juggling numerous pro¬ 
jects, Multi-Edit's session manager will save your entire edit¬ 
ing sessions as menu items to be called upon at a later time. 
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Listing 1 continued 

szModuleFile, sizeof(szModuleFile) )) 

HFILE ERROR) { 

ShowError(E NMODULE, szModuleName): 

1strcpynlpszModuleFI 1 e. of.szPathName, cbNameLen); 

else { 

return lstrlen(pszModuleFile); 

if ( AppendModuleList(ppModuleList. 

} else { 

szModuleName, szModuleFile. TRUE)) { 

char szPathName[128J; 

if (!GetImportModules(ppModuleL1st, 

1 strcpy(szPathName, pszModul ePath); 

szModuleFile, ShowError)) { 

lstrcat(szPathName. szBaseNatne); 

Jclose(hf); 
return FALSE; 

} 

} 

) 

} 

wModules--, ITablePos += sizeof(WORD); 

} 

lclose(hf); 

if (_access(szPathName, 0) != -1) { 

1strcpyn ( pszModuleFi 1 e, szPathName, cbNameLen); 
return Istrlen(pszModuleFile): 

} 

) 

return 0; 

) 

return TRUE; 

} 

BOOL InModuleList(LPMOOULE pModuleList, LPSTR pszModuleName) 

while (pModuleList) { 

int GetlmportFileNametLPSTR pszModuleName, 

if (IlstrcmptpszModuleName, pModuleList->szName)) 

LPSTR pszModulePath. LPSTR pszModuleFile. 
int cbNameLen) 

{ 

HMODULE hModule: 

return TRUE; 

pModuleList = pModulelist->pNext; 

) 

return FALSE; 

OFSTRUCT of; 

} 

char szBaseNameC15]; 

BOOL AppendModuleList ( LPMODULE ‘ppModuleList, LPSTR 

// Get module name from in-memory module table 

pszModuleName, LPSTR pszModuleFile, BOOL fFlag) 

if ((hModule ■ GetModuleHandle(pszModuleName) ) != 0) 

{ 

return GetModuleFileName(hModule, pszModuleFile, 

LPMODULE pNewModule; 

cbNameLen); 

pNewModule = (LPMOOULE)malloc(sizeof(MODULE)); 

// Search for the module filename 

if (! pNewModule) 

IstrcpytszBaseName, pszModuleName); 

IstrcatlszBaseName. ".DLL"); 

return FALSE; 

of.cBytes = sizeof(OFSTRUCT); 

1strcpyn(pNewModule->szNatne, pszModuleName, 9); 
lstrcpyn(pNewModule->szFile, pszModuleFile, 128); 

if (OpenFilelszBaseName, lof. OFJXISTIOFJEARCH) != 

pNewModule-Tflmported = fFlag; 
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Listing 1 continued 

pNewModule->pNext = (LPMODULE)NULL; 

} 

if (!*ppModu1eList) 

VOID FreeModuleList(LPMODULE pModuleList) 

*ppModuleList = pNewModule: 

( 

else { 

LPMODULE pFree; 

LPMODULE pLastModule = *ppModuleList; 
while (pLastModule->pNext) 

while (pModuleList) { 

pLastModule - pLastModule->pNext: 

pFree - pModuleList; 

pLastModule->pNext * pNewModule; 

pModuleList * pModuleList->pNext; 

pLastModule * pNewModule; 

} 

free(pFree); 

} 

return TRUE; 

} 

/* End of File */ 


One of the first things that Getlm- 
portModulesO must do is determine 
whether the file that was passed to it 
is really a Windows executable. The 
first step is to load in the old DOS 
executable header and verify that its 
signature (the first two bytes of the 
header) matches the value 5A4Dh ('M' 
followed by 'Z', if viewed as ASCII 
characters). If the signature matches, 
you know it is probably an ex¬ 
ecutable file. However, since the be¬ 
ginning of a Windows .exe looks ex¬ 
actly like that of a DOS .exe, how can 
you tell whether the file contains the 
extra Windows executable informa¬ 
tion? Chapter 6 of Microsoft's Pro¬ 
grammer's Reference - Volume 4: Re¬ 
sources offers the following prescrip¬ 
tion without further explanation: 



If the word value at offset 18h is 
40h or greater, the word value at 
3Ch is an offset to a Windows 
header. 


RoboHELP® 

RoboHELP guides you through the entire process of creating Help systems and electronic hypertext docu¬ 
ments. Just point-and-click for features such as jumps, topics, and popup windows, to advanced features 
such as macros, colors, secondary windows, etc. Includes Enhanced Hotspot Editor, Screen Capture Utility, 
VBX Control, and more. 


Offset 18h happens to be the position 
in the old-style DOS header that con¬ 
tains the offset of the executable's re¬ 
location table, so GetbnportModulesO 
compares this field with 40h to decide 
whether to proceed. Note that this 
Microsoft document claims that the 
"word" at 3Ch will contain an offset to 
the NE header. However, both The 
MS-DOS Encyclopedia and The Pro¬ 
grammer's PC Sourcebook (both from 
Microsoft Press) claim that the value 
at offset 3Ch is a double word (four 
bytes). GetlmportModulesO assumes 
the value at offset 3Ch is a word (two 
bytes), which will work correctly even 
if it is, in fact, four bytes, so long as 
the offset of the NE header is less 
than 64K. 


WinHelp Video Kit ™ 

Quickly and easily add Video and Sound into your Windows Help systems and easily create “live” video 
product tutorials. Includes Software Video Camera™, Video Wizard™, Video Tester, Video Player, and 
Video for Windows Runtime. 

Mastering WinHelp * 

This video is the best way for Help Authors to become productive immediately. 

WinHelp Tool Kit ™ 

Make your job easier with powerful new tools. Includes Help-To-Word™ Help 
Decompiler, WinHelp Inspector™, WinHelp BugHunter™, WinHelp Graphics 
Locator™, WinHelp Graphics Library™, and WinHelp Style Guide™. 

WinHelp Hyperviewer ™ 

Enables your Help users to print multiple topics at once, navigate using an expand¬ 
able/collapsible heirarchical view, and Search for any text in the Help system 
— not just author-defined search keywords. 

Moving to WinHelp ‘95 M 

Automatically convert your existing Windows 3.x systems to Windows 95 Help systems. Automatically adds 
Windows 95 features and updates your source files. Makes moving to Windows 95 Help easy! 





WinHelp OFFICE Includes 
RoboHELP, the Ultimate 
Help Authoring Tool. 
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Listing 2 module.h — Header file for module.c 


ffdefine E_NFILE 1 // cannot open executable file 
#define E_NM0DULE 2 // cannot find module 
ffdefine E_NMAGIC 3 // not an executable 
#define E_0LDAPP 4 // not a Windows executable 
ifdefine E_C0RRUPT 5 // corrupt executable image 

typedef struct tagMODULE { 

char szName[9]; // module name 

char szFile[128]; // module file name 

BOOL fImported; // module is imported 

struct tagMODULE *pNext; 

} MODULE; 

typedef MODULE FAR *LPM0DULE; 

typedef int (CALLBACK* MODENUMPROC)(LPMODULE, LPARAM); 

typedef void (CALLBACK* MODERRPROC)(int, LPSTR); 

BOOL GetlmportModules(LPMODULE *, LPSTR, MODERRPROC); 

VOID FreeModuleList(LPMODULE); 


/* End of File */ 


At this point, you can be fairly confident that you have 
a Windows executable. The offset at 3Ch tells you where 
to locate the NE header, which contains a wide variety of 
information about the Windows portion of the .exe file, as 
shown in the NEUEXEHDR structure in module.c (Listing 1). Like 
the old DOS header, the new executable header starts 
with two-byte signature, 454Eh in this case ("N" followed by 
'E' if viewed as ASCII characters). This provides an extra 


sanity check to ensure that the file really is a Windows 
executable and is not corrupted. 

The Current Module Name 

Once GetlmportModules() reads the NE header into mem¬ 
ory, it then has to determine the module name of the .exe 
and add that name to the linked list of modules. This is 
important, because the module name can be different 
from the executable's filename (e.g., you can rename a 
.exe file, but its module name is stored inside the file and 
remains unchanged). By inserting the module name into 
the list, GetlmportModules() ensures that any references to 
that name are resolved. The module name resides as the 
first entry in the executable's resident name table, and the 
relative offset to this table is stored in the NE header, 
shown as resname_ofs in Figure 1. Note that I said 'relative 
offset," because the value stored in the NE header is not a 
byte offset from the beginning of the file but rather rela¬ 
tive to beginning of the NE header itself. The module 
name is stored as a Pascal string, which means the first 
byte contains the length of the string and there is no NULL 
byte terminator. After converting the module name to a C 
string, GetlmportModules() calls AppendModuleListO to ap¬ 
pend the module name to the linked list. This function 
takes four arguments: a pointer to the head of the module 
linked list, a pointer to the module name, a pointer to the 
module's filename, and a Boolean flag which indicates if the 
module is imported or an executable's module name. 
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THE TRIP TO CLIENT/SERVER CAN BE HAZARDOUS, 
UNLESS YOU NAVIGATE YOUR WAY WITH BTRIEVE 6. 


Everyone knows the dangers 
in moving to client/server What 
you may not know is that 
Btrieve 6 provides a safe, direct 
route to client/server with total 
control over relational structures 
and distributed data routines. 

So you can chart the fastest path 
to your data. And you can add 
SQL applications at any time. 

INTRODUCING NAVIGATIONAL 
CLIENT/SERVER. 

While SQL provides great flexi¬ 
bility, it can limit your control 
and performance. Navigational 
client/server allows you to cus¬ 
tom design relational structures 
and maximize performance 
with directional controls to 
retrieve, update, insert and 
delete distributed data. 


With Btrieve 6, you'll have 
the transaction processing mus¬ 
cle to build multi-gigabyte data¬ 
base servers supporting hun¬ 
dreds of users with sub-second 
response times. And Btrieve 6 
supports the major server plat¬ 
forms, NetWare, Windows NT, 
and OS/2 LAN Server; and the 
major client platforms. 

FLY PAST RETRAINING 
PROBLEMS. 

Btrieve 6 directional controls 
integrate with existing applica¬ 
tion code so you can selectively 
upgrade your current applica¬ 
tions to client/server Using your 
3, 4 and 5CL tools, merely 
replace your data management 
code with Btrieve 6 and couple 
it with the application code. 



This way your end-users will be 
working with familiar applica¬ 
tions. You'll avoid the need for 
the massive retraining that 
accompanies a sweeping change 
to new applications, an effort 
that takes from 40 to 50 per¬ 
cent of most conversion budgets 
(Source: The Gartner Group). 


PICK UP SQL ALONG THE WAY. 


Btrieve 6 integrates with Scalable 
SQL,™ our award-winning rela¬ 
tional database. Since both are 
built on our new Microkernel 
Database Engine!" SQL applica¬ 
tions work in unison with Btrieve 
applications—each having con¬ 
current access to all data. 

Now you have the freedom 
to write new applications in 
Btrieve or SQL, and the trip to 
client/server will be much more 
manageable. So navigate your 
with Btrieve 6. 


SIMPLY WORKS 

BTRIEVE 


To receive a free white paper, call 
800-BTRIEVE or (512) 794-1719, 
CompuServe (GO BTRIEVE). 
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CHKLIB 


File K 

C:\WIN3.1\SYSTEM\C0MM.DRV 
C:\WIN3.1\SYSTEM\C0MP0BJ.DLL 
C:\WIN3.1\SYSTEM\GDI.EXE 
C:\WIN3.1\SYSTEM\KEYB0ARD.DRV 
C:\WIN3.1\SYSTEM\KRNL386.EXE 
1 C:\WIN3.1\SYSTEM\MMS0UND.DRV 
C:\WIN3.1\SYSTEM\M0USE.DRV 
C:\WIN3.1\SYSTEM\OLE2.DLL 
1 C:\WIN3.1\SYSTEM\OLE2DISP.DLL 
C:\WIN3.1\SYSTEM\OLE2NLS.DLL 
I C:\WIN3.1\SYSTEM\SDM.DLL 
! C:\WIN3.1 \SYSTEM\SHELL.DLL 
C:\WIN3.1\SYSTEM\ST0RAGE.DLL 
1 C:\WIN3.1\SYSTEM\SUPERVGA.DRV 
C:\WIN3.1\SYSTEM\SYSTEM.DRV 
t C:\WIN3.1\SYSTEM\T00LHELP.DLL 
C:\WIN3.1\SYSTEM\USER.EXE 
1 C:\WIN3.1\SYSTEM\WIN87EM.DLL 


D:\BIN\OFFICE\WINWORD\WI N WO RD. EXE 


D:\BIN\OFFICE\WINWORD\WWINTL.DLL 






Figure 2 Demo program for module.c 


The Imported Module Names 

After all this, GetlmportModulesO is finally ready to scan 
the list of modules (DLLs) that the .exe imports. The NE 
header contains (at offset lEh) the count of modules in the 
module reference table. The NE header also contains (at 



GET If! 

TX Text-Control 
brings true 
WYSIWYG Text 
Processing to 
your WINDOWS 
Application. 

New Version 
now available! 

Features 

Multiple fonts • Paragraph formatting • Zooming • Macrofields 
Integration of images • DLL and VBX 1.0 interface • Standard 
version: only $249 with 30 day money back guarantee 

GET YOUR FREE DEMO TODAY! 

Call 1 -800-986-6578 or 913-832-2070 
(North and South America), 

European Software Connection, 

1617 St. Andrews Drive, Lawrence, Kansas 66047, 

USA, Fax: 913 832 8787, CompuServe: 71141,3624 
Elsewhere contact 

DBS GmbH, Kohlhokerstrasse 61,28203 Bremen 
Germany, Phone: +49 421 33 591-0 
Fax: +49 421 339 8658, CompuServe 100013,115 

Or download TXDEMO.ZIP from CompuServe 
(Forum WINSDK, section PUBLIC UTILITIES) 



DBS 


offset 28h) the offset of the module reference table itself. 
This table consists of relative offsets to strings (Pascal-style 
strings again) which contain the module names; these off¬ 
sets are relative to yet another table, the imported names 
table, whose offset resides in the two-byte field at offset 
2Ah in the NE header. In other words, to locate each mod¬ 
ule name, you add together the corresponding offset in the 
module reference table, the offset of the imported names 
table, and the offset of the NE header, as shown in Figure 1. 

GetlmportModulesO loops over the entries in the module 
reference table, performing the necessary calculations to 
read each module name into memory. The function then 
calls InModuleListO to check If the module name has al¬ 
ready been added to the linked list. If it hasn't, Getlmport¬ 
ModulesO calls GetlmportFileNameO (explained next) to de¬ 
termine the filename associated with the module name, 
and then appends the module to the list by passing the 
module name and module filename to AppendModuleListO. 

Filenames from Module Names 

GetlmportFileNameO first determines whether the module 
is already loaded in memory, by passing the module 
name to the Windows API function GetModuleHandleO. If 
the specified module is already in memory, GetModuleHan¬ 
dleO returns its handle. The module handle can be 
passed to the Windows function GetModuleFileNameO to ob¬ 
tain the path to the DLL itself, which GetlmportFileNameO 
can then return to the caller. If the module is not in mem¬ 
ory (GetModuleHandleO returns NULL), then OpenFileO is 
called to search for the file using the 0F_SEARCH and 0F_EX- 
IST flags. The base filename is constructed by simply ap¬ 
pending the .dll extension to the module name, just as 
the Windows loader does (this is the reason why all im¬ 
plicitly loaded DLLs must have a filename that matches 
their module name and have the DLL extension). If Open¬ 
FileO does not find a matching filename, then Getlmport¬ 
FileNameO searches for the file in the directory where the 
parent module is located. 

If GetlmportFileNameO is unable to determine a filename 
for the module, then GetlmportModulesO calls an error func¬ 
tion that you have to supply as one of its parameters. 
Your error function will be passed an integer error code 
defined in module, h (Listing 2), along with the name of the 
file the error refers to. If GetlmportFileNameO did locate the 
filename for the module, GetlmportModulesO recurses with 
the new module, so that any modules it implicitly loads 
can also be added to the linked list. This recursive tech¬ 
nique is also used by the Windows loader to ensure that 
all of the modules required for an application are loaded 
before execution begins. 

Once all of the modules have been added to the linked 
list, GetlmportModulesO returns to the caller, and the 
LPM0DULE pointer that was passed to the function is now 
the head of a list of modules. The sample program on the 
code disk (see Figure 2) simply traverses this list and adds 
all the module names to a listbox. If you double-click on 
any of the entries in that listbox, the sample program re¬ 
sets the listbox and displays the module list for the se¬ 
lected module. □ 
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Manipulating Bitmap Palettes 
in Windows 

Trevor Harmon 


Visual C++ vl .5 
Borland C++ v4.5 
Symantec C++ v6.1 
Watcom C++ vl 0.0 


Bitmaps have become a staple of Windows programming. Even though they 
often serve no purpose but to spice up an application with pretty pictures, 
bitmaps are now as common as pull-down menus. If you don't sell Windows 
programs with bitmaps, you can be sure that your competitors will. Fortunately, 
displaying a bitmap in Windows is easy. You can use your favorite editor to 
draw the bitmap and then include it with your program's resource script. When 
it's time to display the bitmap, you simply call LoadBitmepO; Windows handles 
the work of loading the image into memory and converting it to a displayable 
format. 

Sometimes, however, LoadBitmapO is too restrictive. It locks the image in an 
internal format (called a device-dependent bitmap, or HBITMAP) and makes it 
difficult to edit the bitmap. This article presents a way around the limitation. By 
converting the image into a device-independent bitmap (DIB), you can alter any 
pixel in the bitmap. More important, you can adjust its palette to match colors 
defined by the Control Panel, or even to automatically create a disabled, or 
grayed, version of the bitmap. This article describes the format of device-inde¬ 
pendent bitmaps and shows you how to manipulate their palettes to achieve a 
couple of special effects at runtime. 

DIBs Versus DDBs 

In the early days of Windows, screens and printers were monochrome or 
supported, at most, 16 colors. Windows supported one kind of bitmap, called a 
device-dependent bitmap (DDB). The format of a DDB is determined by the 
device driver (screen or printer) that you asked to create it. The location of a 
DDB is also up to the device driver; for example, a video adapter is free to 
place the actual bits of the DDB into its own private memory, to speed up 
operations. You always operate on a DDB indirectly, via a handle (HBITMAP) re¬ 
turned to you when you initially asked the device to create the DDB (via 
CreateBitmapO, for example). You can, however, copy the pixels that make up 
the DDB into your own memory space from wherever they actually reside, by 
calling GetBitmapBitsO ; still, those bits are useless unless you know the dimen¬ 
sions of the bitmap and how the bits are divided into pixels - information you 
can obtain by having GetObjectO fill in a BITMAP structure. 


Trevor Harmon works for Microdyne Development Technologies, which provides cus¬ 
tom controls and other tools for Microsoft Windows programmers. He is currently pur¬ 
suing degrees in Computer Engineering and German. Trevor can be reached at 
73771.3307@compuserve. com. 
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Figure 1 The structure of a device-independent bitmap 


BITMAPFILEHEADER 


BITMAPINFO 


bitmap bits 


. • 1’B’I'M’I • size • | reserved | bit offseT~~| 


BITMAPINFOHEADER 


RGBQUAD array 
(color palette) 


typedef 

struct tagBITMAPINFOHEADER { 

DWORD 

biSize; 

LONG 

biWidth; 

LONG 

biHeight; 

WORD 

biPlanes; 

WORD 

biBitCount; 

DWORD 

biCompression; 

DWORD 

biSizelmage; 

LONG 

biXPelsPerMeter; 

LONG 

biYPelsPerMeter; 

DWORD 

biClrUsed; 

DWORD 

biClrImportant; 

} BITMAPINFOHEADER; 


typedef 

struct tagRGBQUAD { 

BYTE 

rgbBlue; 

BYTE 

rgbGreen; 

BYTE 

rgbRed; 

BYTE 

rgbReserved; 

} RGBQUAD; 



acceptable scheme. Windows needed 
a way to allow a developer to create 
a single bitmap that used, say, burnt 
orange, and have that bitmap display 
with the desired color (more or less) 
on video adapters from different 
manufacturers with completely differ¬ 
ent internal bitmap formats (assum¬ 
ing the device had sufficient color 
depth). Windows 3.0 introduced the 
device independent bitmap (DIB) to 
address this problem. 

Unlike a DDB, a DIB resides in 
your memory, completely under your 
control. You can t use DDB functions 
such as BitBltO with a DIB, but you 
can copy a DIB to a specific device 
(such as a window display context) 
with the function StretchDIBitsO. 
Both DDBs and DIBs are typically 
stored in files with the .bmp exten¬ 
sion, which adds further to the gen¬ 
eral confusion. 


As color display adapters with more than 16 colors 
proliferated, DDBs became more inconvenient. With only 
16 colors (4 bits per pixel), Windows simply defined what 
each possible color was. With 256 colors (8 bits per pixel) 
or 16 million colors (24 bits per pixel), that was not an 


TM 
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For DOS, OS/2 and Windows-NT 

• The experts loved TLIB 4: 

"...amazingly fast... TLIB is a great system. ” PC Tech Journal 
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the fastest of the reviewed packages." Computer Language 
"I will not program without it." Uptime Magazine 
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changes and undo intermediate revisions. Network and WORM optical 
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Burton Systems Software 
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Why not just forget DDBs and use 
DIBs for everything? One reason is efficiency. Copying 
DIBs to the screen (via StretchDIBitsO) tends to be twice 
as slow (or even worse) than copying DDBs (via BitBltO). 
Another reason is convenience. You can select a DDB into 
a 'memory device context,' but not a DIB. This means that 
you can easily use standard Windows drawing functions 
(DrawTextO, EllipseO, etc.) to draw on the surface of a 
DDB, but not on a DIB (actually, Microsoft did document a 
method for doing this with the 'DIB driver in Windows 
3.1). On the other hand, you can write your own code to 
directly perform custom manipulations on a DIB once it is 
in memory, which you cannot do with a DDB (since you 
only have a handle for a DDB, not direct access to its bits). 

The big news in Windows bitmapped graphics is that 
Microsoft has fairly effectively addressed these two prob¬ 
lems with DIBs. With the advent of the new WinG library 
and CreateDIBSectionO (the function in Windows 95 and 
Windows NT that offers advantages similar to WinG), ap¬ 
plications can use DIBs, retain direct access to the bitmap 
bits, use standard Windows graphics functions to draw on 
the surface of DIBs, and still be nearly as fast as if they 
were using DDBs with BitBltO. This is all the more reason 
to get comfortable with DIBs. 

Loading a Device Independent Bitmap 

Later I will show you how to achieve special effects by 
modifying the palette of a DIB, but first you have to know 
how to load a DIB into memory. For this purpose I as¬ 
sume that you have created a DIB with a bitmap editor, 
and then compiled it into your program as a resource, 
using a resource compiler statement such as: 

IDB_BITMAP BITMAP "bmppal.bmp" 
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The format of a DIB as it exists in a .bmp file is roughly 
outlined in Figure 1. The resource compiler strips off the 
BITMAPFILEHEADER structure, so I don't have to deal with it in 
the code I'm going to present. If you choose to load a DIB 
directly from a .bmp file (as opposed to loading it as a 
compiled-in resource), then you have to deal with the BIT¬ 
MAPFILEHEADER. 

bmppal.c (Listing 1) contains a helper function, LoadDibO, 
to load a bitmap resource into memory as a DIB. You 
pass it the instance of the module that contains the bit¬ 
map resource, the resource identifier (the label you used 
in the BITMAP statement in your .rc file), and the address of 
a TDiblnfo structure, which LoadDibO will fill with various 
useful pieces of information about 
the loaded bitmap. 

LoadDibO uses a trio of functions 
from the Windows API (FindRe¬ 
sourced, LoadResourceO, and LockRe- 
sourceO ). These functions locate the 
bitmap resource, load it into memory, 
and return a pointer to the resource 
as a BITMAPINFO structure (remember 
that the BITMAPFILEHEADER structure 
was stripped off by the resource 
compiler). In fact, the pointer re¬ 
turned by LockResourceO points to the 
entire DIB, not just the BITMAPINFO 
portion, but because both the color 
palette table and the bitmap bits are 
variable in size, I can't determine the 
overall sizes without first inspecting 
the BITMAPINFO structure that lies at 
the beginning of the DIB. 

The number of bits per pixel the 
DIB uses resides in a field called 
biBitCount, which is stored in the BIT- 
MAPINFOHEADER structure of BITMAPINFO 
(see Figure 1). If biBitCount is 1, the 
bitmap is monochrome with only two 
palette colors; if biBitCount is 4, the 
bitmap has 16 colors; if biBitCount is 
8, the palette contains 256 colors; 
and if biBitCount is 24, the bitmap is 
a true-color image and has no pal¬ 
ette. Of course, if the DIB has no pal¬ 
ette, you can't use the palette modifi¬ 
cation tricks presented in this article. 

However, 256 colors or less is more 
than adequate for many situations in 
which an application might need to 
use bitmaps. 

After determining the number of 
colors that the bitmap uses, LoadDibO 
calculates the size of the color palette 
(the array of RGBOUAD structures) in the 
DIB by multiplying the number of col¬ 
ors by the size of an RGBOUAD structure 
(four bytes). Knowing the size of the 
color palette tells LoadDibO how 


many bytes after the end of the BITMAPINFOHEADER structure 
the actual pixels of the bitmap begin. 

LoadDibO allocates global memory to create a copy of 
the color palette in the DIB, and stores a pointer to that 
copy in the IpPalette field of the TDiblnfo structure. In the¬ 
ory, the pointer returned by LockResourceO for the DIB is a 
shared resource. Since I plan to alter that resource directly 
(modifying the color palette of the DIB), I try to restore the 
resource to its original state as soon as possible, to pre¬ 
vent some other code from loading and locking the same 
resource and receiving a pointer to the cached copy of the 
DIB that I have modified. 
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Creating a System Color Bitmap 

The power to manipulate a bitmap's palette carries sev¬ 
eral benefits. Probably the most useful is the ability to 
match certain colors of the bitmap to the system colors of 
the Control Panel. For instance, if you display a bitmap on 
a push button, you cannot assume that the button color 
will be the usual light gray. Instead, you should determine 
the default color for a button, like this: 

GetSysColor(C0L0R_BTNFACE) 

You can then change the bitmap's background to the cor¬ 
rect button color by manipulating its palette. 


bmppal.c (Listing 1) contains a function called LoadSys- 
temColorBitmapO that demonstrates this procedure. It works 
just like the standard LoadBitmapO function, taking an IN¬ 
STANCE and LPSTR as parameters and returning an HBITMAP 
for display. The function begins by calling a helper func¬ 
tion, LoadDibO, to load a bitmap resource into memory as 
a DIB. 

After calling LoadDibO, LoadSystemColorBitmapO is ready 
to manipulate the bitmap's palette. Each color in the pal¬ 
ette is an RGBQUAD structure in BITMAPINFO, holding the red, 
green, and blue color values. The function uses brute 
force to check each RGBQUAD for values that equal the pre¬ 
viously defined background color (cyan in this case) of the 
bitmap. If it finds a match, the function copies the red, 


Listing 1 bmppal.c — Routines to manipulate DIB palettes 

((include <windows.h> 

case 1 ; Info->wNumColors = 2; break; 

#include <windowsx.h> 

case 4 : Info->wNumColors = 16; break; 

((include <string.h> 

case 8 : Info->wNumColors = 256; break; 

/* Background color of the bitmap */ 

default: Info->wNumColors = 0; 

} 

static COLORREF MASK COLOR = RGB(0, 255, 255); 

Info->wPaletteSize = Info->wNumColors * sizeof ( RGBQUAD); 

static COLORREF WHITE = RGB(255,255,255); 

Info->l pBits = (LPSTRKlpbmlnfo) + 

sizeof ( BITMAPINFOHEADER) + Info->wPaletteSize; 

static COLORREF GRAY = RGB ( 128,128,128 ) ; 

/* Make copy of palette */ 

/* Background color of the window */ 

Info->lpPalette = (LPSTR)GlobalAllocPtr(GHND, 

Info->wPaletteSize); 

((define BACKGR0UND_C0L0R GetSysCol or ( C0L0R_BTNFACE) 

if ( Info->lpPalette == NULL ) 

{ 

(Fifndef WIN32 

int ColorEqCRGBQUAD a, COLORREF b) 

{ 

UniockResource(Info->hBitmapResource); 

return a.rgbRed == GetRValue(b) 

FreeResourcetInfo->hBitmapResource); 

&& a.rgbGreen == GetGValue(b) 

(Fendif 

&& a.rgbBlue == GetBValue(b); 

} 

void SetColortRGBQUAD *Quad, COLORREF Color) 

return NULL; 

} 

memcpy(Info->lpPalette, ( LPSTR)lpbmInfo 

{ 

+ sizeof(BITMAPINFOHEADER), Info->wPaletteSize ) ; 

Quad->rgbRed = GetRValue(Col or ); 

return lpbmlnfo; 

Quad->rgbGreen = GetGValue(Color); 

} 

Quad->rgbBlue = GetBValue(Color); 

} 

/*********************************************************** 

typedef struct TDiblnfo 

* This function loads a bitmap resource, changes * 

* MASK COLOR to BACKGROUND COLOR, and returns the image in * 

{ 

* the form of an HBITMAP. * 

HGLOBAL hBitmapResource; 

a**********************************************************/ 

WORD wNumColors, wPaletteSize; 

HBITMAP LoadSystemColorBitmap(HINSTANCE hBitmapInstance, 

LPSTR IpPalette, lpBits; 

LPCSTR IpszBitmap) 

} TDiblnfo; 

{ 

/* utility function for loading DIBs */ 

struct TDiblnfo Info; 

LPBITMAPINFO lpbmlnfo; 

static LPBITMAPINFO LoadDib(HINSTANCE hBitmapInstance, 

HDC hdcMemory; 

LPCSTR IpszBitmap, struct TDiblnfo *Info) 

WORD i; 

{ 

HBITMAP hBitmap; 

HRSRC hrsrcBitmap; 

LPBITMAPINFO lpbmlnfo; 

lpbmlnfo = LoadDib(hBitmaplnstance, IpszBitmap, AInfo); 

hrsrcBitmap = FindResourceChBitmapInstance, IpszBitmap, 

ifdpbmlnfo == NULL) 
return NULL; 

RT BITMAP); 

for (i = 0; i < Info.wNumColors; i++) 

Info->hBitmapResource = LoadResourceC hBitmapInstance, 

if ( ColorEqt 1pbmlnfo->bmiColors[i D . MASK COLOR ) ) 

hrsrcBitmap); 

SetColor ( &1pbmlnfo->bmiColors[i ] , BACKGROUND COLOR); 

lpbmlnfo = (LPBITMAPINFO) 

hdcMemory = GetDC(NULL); 

LockResource(Info->hBitmapResource); 

hBitmap = CreateDIBitmapthdcMemory, &1pbmInfo->bmiHeader, 

if ( lpbmlnfo == NULL ) 

CBM INIT, Info.lpBits. lpbmlnfo, DIB RGB COLORS); 

{ 

memcpy( ( LPSTRJ1pbmlnfo + sizeof(BITMAPINFOHEADER), 

(fifndef WIN32 

Info.IpPalette, Info.wPaletteSize); 

FreeResourcetInfo->hBitmapResource) ; 

GlobalFreePtrtInfo.IpPalette); 

#endif 

ReleaseDCtNULL, hdcMemory); 

return NULL; 

} 

#ifndef WIN32 

switch ( 1pbmInfo->bmiHeader.biBitCount ) 

UniockResource(Info.hBitmapResource); 

{ 

FreeResourcetInfo.hBitmapResource); 
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green, and blue values of the default 
window color to the RGBQUAD. (Most of 
this code has been condensed into 
functions for easier reading.) If neces¬ 
sary, you can easily expand this por¬ 
tion of the function in order to match 
other colors in the bitmap with cer¬ 
tain system colors. 

The DIB now has the desired color 
palette. You could display the DIB by 
calling StretchDIBitsO. However, un¬ 
less you use WinG, StretchDIBitsO is 


quite a bit slower than BitBltO'mg a 
device-dependent bitmap (DDB). For 
that reason, LoadSystemColorBitmapO 
converts the DIB into a DDB. Win¬ 
dows provides an API function just 
for this purpose. The function is 
called CreateDIBitmapO, but that is a 
slight misnomer. Instead of creating a 
DIB, as the name would imply, it ac¬ 
tually creates a device-dependent bit¬ 
map from a DIB. In any event, Load¬ 
SystemColorBitmapO calls CreateDIBit¬ 


mapO and passes it the required infor¬ 
mation about the DIB. CreateDIBit¬ 
mapO returns an HBITMAP handle, and 
LoadSystemColorBitmapO gives this 
handle back to its caller. 

Before exiting, LoadSystemColorBit¬ 
mapO cleans up after itself by calling 
UnlockResourceO and FreeResourceO. 
These functions unlock and free the 
bitmap resource loaded at the begin¬ 
ning of LoadSystemColorBitmapO. Note 
that neither function exists under 


Listing 1 continued 

#endif 

memcpy( ( LPSTR)1pbmlnfo + sizeof ( BITMAPINFOHEADER), 


Info.1pPalette, Info.wPaletteSize) ; 

return hBitmap; 


} 

for (i = 0; i < Info.wNumColors; i++) 


if ( ColorEql lpbmInfo->bmiColors[i], MASK_C0L0R ) II 

j ★★***★*★*★*★★★*★★★*★★*★★★•*•★★* ★★★★**★★*★★****★★★***★★★★**★★★ 

ColorEql lpbmInfo->bmiColors[i], RGBI255, 255, 255) ) II 

* This function loads a bitmap resource, creates a * 

ColorEqC 1 pbml nf o->bmi Col ors [i 3 . RGBU92, 192, 192) ) ) 

* disabled version of the image, and returns it as an * 

SetColorlSlpbmInfo->bmiColors[i], WHITE); 

* HBITMAP. * 

else 

★★★★★★★★★★★★★★★★★★★★★★•Hr************************************ i 

SetColor(&lpbmInfo->bmiColors[1], RGB(0,0,0)); 

HBITMAP LoadDisabledBitmap(HINSTANCE hBitmapInstance, 

hTempBitmap = CreateDIBitmapthdcMemory, 

LPCSTR IpszBitmap) 

&1pbmInfo->bmiHeader, CBM INIT, Info.lpBits, 

{ 

lpbmlnfo, DIB_RGB_C0L0RS) ; 

struct TDiblnfo Info; 

LPBITMAPINFO lpbmlnfo; 

hOldBitmap = SelectBitmapIhdcBitmap, hTempBitmap); 

HDC hdcMemory, hdcBitmap, hdcCanvas; 

BitBltlhdcCanvas, 0, 0, ( int ) 1pbmInfo->bmiHeader.biWidth, 

WORD i ; 

( int)lpbmInfo->bmiHeader.biHeight, hdcBitmap, 0, 0, 

HBITMAP hBitmap, hTempBitmap, hOldBitmap; 

SRCAND); 

HBRUSH hBackgroundBrush; 

SelectBitmapIhdcBitmap, hOldBitmap); 

DeleteBitmapIhTempBitmap); 

lpbmlnfo = LoadDib(hBitmaplnstance, IpszBitmap, Mnfo); 
if(lpbmlnfo == NULL) 

memcpylILPSTR)lpbmlnfo + sizeof(BITMAPINFOHEADER), 

return NULL; 

Info.IpPalette, Info.wPaletteSize ); 

/* Create memory bitmap */ 
hdcMemory = GetDC(NULL); 

for (i = 0; i < Info.wNumColors; i++) 

hdcBitmap = CreateCompatibleDC(hdcMemory) ; 

if I ColorEql lpbmInfo->bmiColors[i], MASK_C0L0R ) II 

hdcCanvas = CreateCompatibleDC(hdcMemory) ; 

ColorEql 1pbmlnfo->bmiColors[i ] , RGBI255, 255, 255) ) II 

hBitmap = CreateCompatibleBitmap(hdcMemory, 

ColorEql 1pbmInfo->bmiColors[i], RGBI192. 192, 192) ) ) 

(int)1pbmlnfo->bmiHeader.biWidth, 

SetColor(&lpbmInfo->bmiColors[i], RGBI0.0.0)); 

(int)1pbmlnfo->bmiHeader.biHeight); 

else 

SelectBitmap(hdcCanvas, hBitmap); 

SetColorl&lpbmInfo->bmiColors[i]. GRAY); 

hBackgroundBrush = CreateSolidBrush( BACKGROUND COLOR ); 

hTempBitmap = CreateDIBitmapthdcMemory, 

SelectBrushlhdcCanvas, hBackgroundBrush); 

&1pbmInfo->bmiHeader, CBM INIT, Info.lpBits. 

RectanglelhdcCanvas, -1, -1, 

lpbmlnfo. DIBJGBJOLORS); 

(int)(1pbmInfo->bmiHeader.biWidth + 1), 

(int)(1pbmInfo->bmiHeader.biHeight + 1)); 

hOldBitmap = SelectBitmapIhdcBitmap, hTempBitmap); 

SelectBrushlhdcCanvas, GetStockBrush(NULL BRUSH)); 

BitBltlhdcCanvas. 0, 0, Iint)lpbmInfo->bmiHeader.biWidth, 

DeleteBrush(hBackgroundBrush); 

(int)1pbmlnfo-AbmiHeader.biHeight. hdcBitmap, 0, 0, 

SRCPAINT); 

for (i = 0; i < Info.wNumColors: i++) 

SelectBitmapIhdcBitmap, hOldBitmap); 

if ( ColorEql 1pbmInfo->bmiColors[i]. MASK_C0L0R ) II 

DeleteBitmapthTempBitmap); 

ColorEq( lpbmInfo->bmiColors[i], RGBI255, 255, 255) ) II 

memcpylILPSTR)1pbmlnfo + sizeof(BITMAPINFOHEADER). 

ColorEql 1 pbmlnf o->bmi Col ors [i ]. RGBU92. 192, 192) ) ) 

Info.IpPalette, Info.wPaletteSize); 

SetColor(&lpbmInfo->bmiColors[i], BACKGR0UND_C0L0R); 

DeleteDCIhdcCanvas); 

else 

DeleteDCIhdcBitmap); 

SetColor(&lpbmInfo->bmiColors[i], WHITE); 

ReleaseDCINULL, hdcMemory); 

GlobalFreePtrIInfo.1pPalette); 

hTempBitmap = CreateDIBitmapthdcMemory, &lpbmInfo-> 


bmiHeader, CBM INIT, Info.lpBits, 

#ifndef WIN32 

lpbmlnfo, DIB_RGB_C0L0RS); 

UniockResourcelInfo.hBitmapResource); 

FreeResourcelInfo.hBitmapResource); 

hOldBitmap = SelectBitmapthdcBitmap, hTempBitmap); 

BitBltlhdcCanvas, 1, 1, (int)1pbmInfo->bmiHeader.biWidth. 

#endif 

(int)1pbmInfo->bmiHeader.biHeight, hdcBitmap, 

return hBitmap; 

0, 0, SRCCOPY); 

} 

SelectBitmapIhdcBitmap, hOldBitmap); 

DeleteBitmapthTempBitmap); 

/* End of File */ 
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Win32. Because Win32-based operat¬ 
ing systems, such as Windows NT, 
use memory-mapped resources and 
virtual pointers, unlocking and free¬ 
ing a resource isn't necessary. 

Creating a Disabled Bitmap 

Manipulating a bitmap's palette 
has another practical purpose. You 
can load any image and, by perform¬ 
ing a few magic tricks on its palette, 
automatically generate a 'disabled' 
version of the same bitmap. The fin¬ 
ished image has the aesthetically 
pleasing embossed look commonly 
seen on Windows toolbars. This tech¬ 
nique saves you the time, effort, and 
disk space required to create the dis¬ 
abled version of a bitmap yourself. 

bmppal.c (Listing 1) includes a func¬ 
tion called LoadDisabledBitmapO that 
illustrates the process. Like LoadSys- 
temColorBitmapO, this function has 
HINSTANCE and LPSTR parameters for lo¬ 
cating the bitmap resource, and it re¬ 
turns an HBITMAP for displaying the fi¬ 
nal image. (After displaying any HBIT¬ 
MAP, always remember to delete it by 
calling the Windows API function 


DeleteBitmapO.) Like LoadSystemColor- 
BitmapO, LoadDisabledBitmapO calls 
LoadDibO to get the DIB" resource into 
memory. 

From there, the similarities be¬ 
tween the two functions end. The pri¬ 
mary difference in LoadDisabledBit¬ 
mapO is that it creates three bitmaps 
based on the original image and 
overlays them to create the grayed 
bitmap. Rather than loading the bit¬ 
map resource three times it uses the 
extra copy of the DIB palette pro¬ 
vided by LoadDibO. After creating 
each bitmap, it restores the original 
palette from the memory block. 

Typical bitmap operations will 
draw the image to a window's device 
context, or DC. But LoadDisabledBit¬ 
mapO doesn't have a window; in¬ 
stead, it draws the image on another 
bitmap. To accomplish this task, the 
function begins by calling CreateCom- 
patibleDCO, to set up a device con¬ 
text in memory named hdcCanvas. It 
then calls CreateCompatibleBitmapO to 
produce an HBITMAP. This bitmap will 
become the disabled version re¬ 
turned to the function's caller. Finally, 



Figure 2 Demonstrating DIB 
palette manipulation 


the function uses SelectBitmapO to 
place the bitmap into the hdcCanvas 
device context. Any drawing on 
hdcCanvas will now go to the bitmap, 
not a window. 
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After preparing hdcCanvas, LoadDisabledBitmapO can be¬ 
gin painting the disabled bitmap. Its first step is to lay a 
simple foundation by drawing a rectangle using the back¬ 
ground color. Next, it searches the DIB's palette for white, 
light gray, and the bitmap's background color. If a palette 
color matches one of these the code changes it to the 
window background color. Otherwise, it changes the color 
to white. When all colors have been processed, the func¬ 
tion converts the DIB to an HBITMAP and draws it on 
hdcCanvas one pixel down and one pixel right. Lastly, it 
resets the DIB by copying back the original palette. 

The next phase is a bit trickier. Although the essential 
step is to draw a new version of the bitmap with dark 
gray colors, doing that will paint over the previous image. 
LoadDisabledBitmapO prevents this by creating a mask of 
the bitmap. When this mask is ANDed (SRCAND) to 
hdcCanvas, and the non-masked bitmap is ORed 
(SRCPAINT), the image's background disappears. 

To create the mask, the function once again parses 
each color in the DIB's palette. It changes any color that 
should disappear - white, light gray, and the bitmap's 
background color - to white. Repeating its earlier steps, 
the function creates an HBITMAP from the DIB mask and 
then ANDs it onto hdcCanvas. 

Once again LoadDisabledBitmapO resets the DIB palette 
and begins to make a new one. This time, it changes the 
white, light gray, and bitmap background colors to black 
and all other colors to dark gray. The function converts 


the image to a device-dependent bitmap for the third and 
final time and then ORs it onto hdcCanvas. The resulting 
image is dark gray, with a dash of white pixels in strategic 
locations for a 3-D appearance. 

Sample Program 

The code disk (see table of contents for availability) 
contains a sample program that uses the functions in 
bmppal.c (Listing 1) to display a color DIB normally, with a 
revised background color, and as a disabled bitmap. You 
can see the result in Figure 2. The code disk also includes 
bldpal.bat, which contains commands to build the sample 
program with Borland C++ v4.5, Visual C++ vl .5, Syman¬ 
tec C++ v6.1, or Watcom C++ vl 0.0. 

Conclusion 

While bitmaps can add value to your application, they 
can also add complexity. Windows provides dozens of 
functions for working with bitmaps, and their purpose is 
not always clear. The broad variety of display types, pal¬ 
ette sizes, and image formats only adds to the confusion. I 
hope this article helps clear up the mystery that may sur¬ 
round device-independent bitmaps and their palettes. It 
should also serve as a launching pad towards writing your 
own bitmap routines. With a little effort, your programs 
can have a professional look that gives you the edge on 
any competitor. □ 
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Drivers 
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Device drivers have historically been the realm of gung-ho programmers 
who speak only kernel-mode assembly language. With Windows 3.x though, 
Microsoft swept a hodgepodge of more generally useful API functions under 
the rug of device drivers, where they lie in wait for programmers willing to put 
up with Microsoft's lack of support or poor documentation for them. Along with 
low-level, VxD functionality, the device driver API includes some useful high- 
level functions. One example is the set of functions that Windows 3.x device 
drivers use for output. This article shows you how to access these functions 
directly (no DDK required!), in order to bypass any printer driver that may be 
installed. 

When Printer Drivers Get in the Way 

I have a PostScript printer in my office, and at least a passing acquaintance 
with generating PostScript code to print text and graphics. Since I know that 
PostScript contains complete logic for half-toning, I found it frustrating that Win¬ 
dows programs consistently produced awful-looking bitmap images on my 
printer. I decided I would just write a little utility that generated the PostScript 
necessary to nicely print a bitmap and then send that directly to my printer. It 
soon became clear to me that the main technical hurdle was how to get com¬ 
plete control over the data being sent to the printer from a Windows program. 


Ron Burk is the editor of Windows/DOS Developer's Journal and has been a pro¬ 
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Listing 1 printc — A function to bypass the printer driver 


/* 

* print.c - code to handle printing a file. 

*/ 

♦include <stdio.h> 

♦include <string.h> 

♦include <windows.h> 

// Note that everybody's print.h has the wrong type for the 
// third argument to OpenJobO, that’s why I have to cast 
// the HDC to an HPJOB. 

♦define PRINTDRIVER /* to enable definitions in print.h */ 
♦include <print.h> 


♦define BUFFER_SIZE 4096 

int PrintFile(HDC PrinterContext. char *Port. 

HWND ParentWindow, char ‘Filename) 

{ 

HPJOB Job; 

char ‘Buffer = new char[BUFFER_SIZE+1]; 

if(Buffer == NULL) 

{ 

MessageBoxtParentWindow, 

"Insufficient memory for file copy", 
"PassThru", MB_0K|MB_IC0N$T0P); 

return FALSE; 

} 

FILE ‘InputFi1e = fopentFilename, "rb"); 
ifdnputFile == NULL) 

{ 


char Message[128]; 
sprintf(Message, 

"Can’t open file ’%s' for reading.". Filename); 
MessageBox(ParentWindow, Message. "PassThru", 

MB_0K|MB_IC0NST0P); 

delete Buffer; 
return FALSE; 

} 

Job = OpenJobtPort, Filename, (HPJOB)PrinterContext); 
StartSpoolPageCJob); 

HCURSOR OldCursor = SetCursor(LoadCursor(NULL, IDC_WAIT)); 

size_t NBytes = 0; 

for(;;) 

{ 

NBytes = fread(Buffer, 1. BUFFER_SIZE, InputFile); 
if(NBytes > 0) 

WriteSpooKJob, Buffer. NBytes); 

else 

break; 

} 

SetCursor(OldCursor); 

EndSpoolPage(Job); 

CloseJob(Job); 

Del eteDC(PrinterContext); 
fclose(InputFile); 
delete Buffer; 
return TRUE; 

} 

/* End of File */ 
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My first thought for sending data directly to my printer 
was to use the normal Windows printing functions, and 
then use the EscapeO function, with an escape code of 
PASSTHROUGH. The documentation for this escape code says 
that it 'allows the application to send data directly to the 
printer, bypassing the standard print-driver code.' This 
technique certainly will let you insert custom data into the 
printing stream, and I was able to more or less accomplish 
my goal of using PostScript to print bitmaps nicely. 

Later, though, Robert Ward (our publisher) needed 
more complete control over printer output. He wanted to 
be able to simply copy a PostScript file submitted by an 
author directly to the PostScript printer from Windows. 
That's an easy task under DOS, but 
under Windows, the Windows printer 
driver will insist on sending its 
header PostScript commands to the 
printer first, which was not accept¬ 
able. Robert experimented with 
promising-sounding printer escape 
codes, such as EPSPRINTING, POST¬ 
SCRIPT GNORE, and POSTSCRIPT_DA TA, 

but in the end we had to conclude 
that if you use the normal Windows 
printing functions, there is no way to 
prevent the printer driver from pre¬ 
pending or appending its own data 
to your data. The printer driver may 
think it is doing you a favor, but 
when you want complete control 
over the data going to the printer, 
this is the kind of favor you can live 
without. 

Another possibility that looked at¬ 
tractive was to use the functions for 
talking directly to serial and parallel 
ports - OpenComnO, HriteComO, and 
so on. Robert tried these out and the 
result was a more subtle problem. 

The code worked when the printer 
was local, but when the printer re¬ 
sided on the network, the network 
redirector seemed unable to pick up 
the output from these functions. The 
situation was turning into one of 
those Windows programming deba¬ 
cles where you spend days and days 
trying to perform a seemingly trivial 
task. 

The network problem led us to a 
solution. If the network redirector in 
question did not intercept calls to 
HriteComO, exactly how did it inter¬ 
cept output? if we could figure out 
what calls device drivers use to write 
to the printer, we could use those 
calls ourselves; this technique would 
surely give us complete control over 
the printer output and should work 


correctly whether the printer was local or remote. Paula 
Tomlinson, who used to work on HP printer drivers, pro¬ 
vided the answers. The Microsoft DDK documents a set of 
functions that essentially send output to the spooler if it is 
running, and to the printer port if it is not. These are the 
functions that printer drivers use. Although they are docu¬ 
mented only in the DDK documentation, the functions re¬ 
side in Windows and are defined in a header file that 
ships with every Windows C++ compiler. Thus with only 
the documentation i provide here, you can completely 
control what custom data you send to your printer from a 
Windows program. 
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over other Windows 
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• APIs for Windows Sockets, Berkeley 
Sockets, ONC RPC/XDR, Telnet, FIT, 
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• Supports NDIS, ODI or Packet drivers, 
SLIP, CSLIP and PPP w ith scripting. 
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Workgroups, Netware, Lan Manager, 
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• Over 400 KB source code samples 
in C, C++, and Pascal. 

• Small, fast and robust 100% DLLs, 
allow up to 128 concurrent sessions. 

• Includes C++ Class Libraries for 
Windows Sockets, Telnet and FTP. 
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The Spooler Output Functions 

If you poke around the Windows include files that 
come with your compiler, you will find print.h, which con¬ 
tains functions that device drivers use for printing. The 
DDK documentation for these functions was less than 
crystal clear, but with only a little tinkering I was able to 
use them to send data directly to the printer, bypassing 
the printer driver, print, c (Listing 1) contains the source to 
PrintFileO, a function I wrote to copy a file directly to a 
printer. It requires a printer device context, the name of 
the port associated with the printer, a parent window (NULL 
is OK), and the name of the file to copy to the printer. 

A handful of functions defined in print, h do the job. 
OpenJobO returns a print job handle required by the other 
functions. StartSpoolPageO and EndSpoolPageO have noth¬ 


ing to do with printer pages; all the text emitted between 
these two function calls gets stored in a separate tempo¬ 
rary file by the spooler, to be printed by Print Manager. 
For simplicity, PrintFileO only uses one spool page, so 
Print Manager will not get called. UriteSpoolO is just the 
output function; you give it a job handle, a buffer to write, 
and the buffer length. Finally, when you are through emit¬ 
ting text and have called EndSpoolPageO to end the most 
recent output spool page, you call CloseJobO to terminate 
the printer output. 

Summary 

The code disk (see Table of Contents for availability) 
contains a sample program, passthru.exe, which lets you 
select a printer, then copy a file directly to that printer. 
The program displays a simple dialog (see Figure 1) and 
relies on common dialogs to let you select a file or printer. 
The code disk also contains bldpass.bat, a batch file which 
can build the sample program with either Borland C++ 
v4.5, Visual C++ vl.5, Symantec C++ v6.10, or Watcom 
C++ vl 0.0. This code first appeared in the premiere issue 
of Network Administrator (March/April 1994). 

It would be nice if device drivers could be left to a 
relative handful of specialists. Under Windows, though, if 
you ignore device driver information, you are cutting 
yourself off from resources that can be useful even in writ¬ 
ing simple applications. Picking up Windows device driver 
information may be painful, but the payoff is a better 
mental model of how Windows actually works. □ 
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iiWhen you can’t be there 
to demonstrate a 
program yourself, Dan 
Bricklin’s demo-it! makes 
an effective stand-in.” 

PC Magazine - April 11,1995 



WHAT YOU DEMO IS WHAT YOU SELL! 


W hether you’re in development, sales or 
marketing, demo-it! is the Windows tool 
for creating fully interactive or self-running 
demos, tutorials, help scripts and 
tradeshow presentations, demo-it! was created by 
Dan Bricklin - the creator of DEMO II, the world’s 
best-selling DOS demo, prototyping and tutorial tool 
- specifically for demonstrating and presenting 
Windows applications. 


KEY FEATURES 

• Utilizes simple but powerful slideshow metaphor 

• Incorporates text, lines, bitmaps, screenshots, rectangles, 
transitions and sound 

• Navigates demos with timer, keyboard and mouse events 

• Runs demos off a single floppy disk without installing on the 
user's machine 

• Works effectively with CD-ROM's, BBS's and on-line services 

• Executes demos with a 160KB run-time player 

• Launches external programs 

$299 
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((Windows evangelists who 
want to spread the word with 
a touch of flair can hardly go 
wrong with this powerful 
presentation tool. ” 

Windows Magazine - May 1995 
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Dan Bricklin's is a registered trademark of Daniel S. Bricklin. demo-it! is a 
trademark of Lifeboat Publishing. Windows is a registered trademark of 
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A Byte-Exchange Variant 
in 486 Processors 


F.M. de Monasterio 

Undocumented opcodes in Intel processors perform a number of functions useful 
to programmers. This article examines an undocumented 80486 opcode that pro¬ 
vides a convenient register transfer function for code that deals with 32-bit regsters. 

Big Endian/Little Endian 

Bytes are stored consecutively in memory, but different machine architectures 
store multi-byte integers in one of two different orders. They store integers either 
with the most significant bytes at lower byte addresses, or vice versa. The pros and 
cons of the two different orderings have been the subject of much argument, and 
the topic was summarized neatly by D. Cohen in an article in the October 1981 
issue of Computer. That article drew an analogy between the byte-order arguments 
and those in Jonathan Swift's Gulliver's Travels. In Swift's satire, the Big-Endians of 
the island empire of Liliiput, a traditionalist group who persisted in breaking their 
eggs at the big end before eating them, were regarded as heretics by the reformist 
Little-Endians and the emperor, who, upon great penalties, required all subjects to 
break their eggs at the little end. Cohen used the term 'big endian' to refer to 
machines that store the most significant bytes at the lowest byte addresses, and 
the term 'little endian' to refer to machines that store the least significant bytes of 
integers at the lowest byte addresses. 

Historically, big endian machines have included the IBM 360, MIPS, Mo¬ 
torola, and SPARC, while little endian machines include the DEC VAX, DEC RISC, 
and the Intel 80x86 family. For the most part, the byte ordering is transparent 
to programmers. The order becomes apparent, however, when you need to 
move data between different machines. In that case, you must know the byte 
order of both machines, or you must first transform the integer data to some 
intermediate portable format, such as ASCII text. Converting integers between 
the two different formats is just one example of the need to rearrange the byte 
order of an integer. 

The BSWAP Instruction 

The documented 80x86-instruction set contains two instructions that convert 
between the two endian formats. First, the 

XCHG <op8,op8> 

variant of XCHG swaps two register bytes and is available in all 80x86 processors. 
Second, the 

BSWAP <op32> 

instruction byte-swaps four byte values and was introduced with the 80486 
processor in 1989. BSWAP exchanges bytes 3 and 0, and bytes 2 and 1 of the 


F.M. de Monasterio is a medical doctor interested in assembly programming. He can be 
reached at P.O. Box 263, Cabin John, MD 20818-0263. 
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specified, 32-bit general register (i.e., bits 24-31 with 0-7, 
and bits 16-23 with 8-15). The exchange reverses the or¬ 
der of the bytes, leaving the result in the same general 
register; thus, if EAX contained 76543210!) before BSUAP EAX, 
it would contain 10325476!i after the instruction was exe¬ 
cuted. The operation essentially consists of five microcod¬ 
ing steps: 


temp 

<= t 

lest 


dest [07. 

..00] 

<= 

temp [31...24] 

dest [15. 

..08] 

<= 

temp [23...16] 

dest [23. 

..16] 

<= 

temp [15...08] 

dest [31. 

..24] 

<= 

temp [07...00] 


BSUAP implements 32-bit endian format conversion in 
one clock count, without asserting the hardware LOCK sig¬ 
nal or affecting the flags register, and is especially useful 
in network exchanges between machines with different ar¬ 
chitectures. As noted by M. Abrash in his book Zen of Code 
Optimization, alternative methods of rotating a 32-bit regis¬ 
ter involve non-trivial penalties; my own software timings 
show that 


lodsd 

; DS:SI => EAX 

bswap EAX 

; endian conversion 

stosd 

; ES:DI <= EAX 


Add ZylNDEX full-text 
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your application. 
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The ZylNDEX Toolkit 
High-level Application 
Programming Interface 
(HAPI) is specially 
designed for easy, fast 
implementation. Ideal 
for use with popular 
high-level authoring 
environments such as 
Visual Basic. 

ZylNDEX is the top- 
rated text retrieval 
application, and has led 
the market since 1984. 
Now, your application 
can take advantage of 
advanced full-text 
retrieval technology 
from ZyLAB. 


Query Constructs: 

• word 

• phrase 

• wildcards 

• proximity 

• delimited search 

• quorum 

• file name 

• file date 

• numeric range 

• Boolean operators 

• unrestricted nest 

• concepts 

• field search 

• progressive search 

Fuzzy Searching 

Overcomes ambiguities 
such as misspellings 
that can result from 
OCR limitations. 

Pricing 

Standard Toolkit:$3995 
Fuzzy Search Version:$4995 

Windows, NT and DOS 
versions available. 



Z ylNDEX 

Developer's Toolkit 


In U.S. 1-800-894-6602 
In Europe 011 (31)20-696-6277 


a division ofZyCO International 


is faster than alternatives involving 
AH/AL exchanges or EAX rotations, or 
both, by a factor of 3 or more. Natu¬ 
rally, BSUAP has other applications. 
Abrash points out that BSUAP can be 
used to simplify pixel bit rotations in 
graphic modes, and R. Hummel men¬ 
tions in his book The Processor and 
Coprocessor that BSUAP can handle 
BCD or ASCII operands that, by con¬ 
vention, are stored using the big-en¬ 
dian format. Yet another ancillary ap¬ 
plication is to facilitate double-word 
video writes, as when filling the 
screen in video text mode, to avoid 
cycle penalties for longer single-word 
writes. 

An interesting side effect of the 
nature of the Intel set encoding is 
that BSUAP has an undocumented 
variant. This undocumented variant 
came to light because older assem¬ 
blers do not recognize the BSUAP op¬ 
code, a limitation one can work 
around by hard-coding its opcode 
byte values. In assembly language, 
the BSUAP instruction is coded like 
this: 

db 00001111b 
db 11001<reg> 

where <reg> equals 000b through 
111b for the sequence EAX, ECX, EDX, 
EBX, ESP, EBP, ESI, and EDI of the gen¬ 
eral registers. When used under a 
.286 or usel6 code directive (i.e., code 
segment descriptor bit D=0), the 
above opcodes must be preceded by 
the operand-size prefix (66h), just as 
when extending a 16-bit instruction 
into its 32-bit form. Otherwise, the in¬ 
struction selects a 16-bit operand, 
namely the lower two bytes of the 
specified 32-bit register. (Due to the 
toggling nature of the operand size 
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DATA SOLUTIONS 


prefix, a 16-bit operand would also 
result were the prefix to precede the 
BSUAP instruction under a use32 code 
segment directive.) 

BSUAP is only documented as oper¬ 
ating on 32-bit registers. Hummel, in 
The Processor and Coprocessor, says 
that using BSUAP on a 16-bit register 
yields an 'undefined' result. Nonethe¬ 
less, the undocumented 16-bit form 
of this instruction can have a practi¬ 
cal use since it provides consistent re¬ 
sults. For example, if EAX contained 
76543210h before BSUAP AX, it would 
contain 76545476h after execution. The 
operation only copies bits 24-31 into 
0-7 and bits 16-23 into 8-15, without 
exchanging them. Hence, what is ob¬ 
tained is a mirror-like image of the 
register bytes, with the mirror placed 
between bits 16 and 15; a microcod¬ 
ing interruption after the third basic 
step noted above may explain this 
result. Since BSUAP was apparently en¬ 
visioned for full-operation size only, 
its encoding contains no operand 
length field (w), so it is not possible 
to generate an 8-bit variant of the in¬ 
struction. 

Uses for 16-Bit BSWAP 

A frustrating limitation of the 
availability of 32-bit registers is that 
their high word, bits 31 through 16, 
cannot be accessed directly as a 


separate 16-bit register. The undocu¬ 
mented 16-bit variant of BSUAP has 
the value of allowing access to the 
high word of 32-bit general registers 
in a manner approaching 16-bit half 
independence. This is so because the 
variant provides a neat way to re¬ 
trieve such high words, essentially as 
if reading from a separate 16-bit, Big- 
Endian register. This retrieval is very 
economical, since it uses only 2 bytes 
and 1 clock count (usel6), or 2+1 
bytes and 1+1 clock counts ( use32), 
while preserving the contents of the 
register high word. Contrast this to 
bit rotations: to read and preserve 
the high word of, say, EAX, one has to 
either (1) save EAX, rotate EAX by 16, 
read AX, and then restore EAX, or (2) 
rotate EAX by 16, read AX, and then 
rotate EAX by 16 again. Either alterna¬ 
tive results in slower and bulkier code 
than the 16-bit version of BSUAP AX. 

Assembly language programming 
commonly runs out of CPU registers, 
especially in critical sections, where 
CX, the typical loop counter, often 
ends up performing double duty. The 
16-bit variant of BSUAP could be useful 
in these cases. For example, under a 
usel6 directive, an 8-bit immediate 
value used frequently by CX in loops 
could be preloaded (in big-endian for¬ 
mat) into bits 24-31 of ECX by 
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db 66h ; op-size prefix to 
mov CX,<8-bit invned> 

SHL 20 ; load ECX (big endian) 

When needed, this value could then 
be retrieved into CX via BSUAP CX, with¬ 
out having to use memory for tempo¬ 
rary storage during the loops and 
while preserving the high word of ECX. 

Although at the time of this writ¬ 
ing there is no reference to the 16-bit 
variant of BSUAP in lists of undocu¬ 
mented 80x86 instructions (e.g., F. 
van Giiluwe's The Undocumented PC 
and H. Feldman's 86bugs. 1st, which is 
distributed with R. Brown's MS-DOS 
Interrupt List), and Intel's Technical 
Support staff seem unaware of it, I 
have verified its support in many 
80486 processors. However, since 
the 80486 has, so far, the most vari¬ 
ants of the Intel family, two disclaim¬ 
ers may be necessary. All the chips 
supporting the operation were Intel 
486 step B or later (since none sup¬ 
ported the early opcode for CMPXCHG, 
00001111b 10100110b, which is 
valid only on step A chips), but I do 
not know yet if the 16-bit variant of 
BSUAP is supported in all of the Intel 
80486 step revisions. Similarly, I do 
not know if the variant is supported 
in 80486 chips made by AMD, Cyrix, 
IBM, or Texas Instruments. 


As in cases when a bug is con¬ 
verted into a feature, the documenta¬ 
tion of the BSUAP variant should be 
beneficial to programmers at presum¬ 
ably little cost to manufacturers. In 
this respect, the application of a Big- 
Endian conversion instruction for lit¬ 
tle-endian purposes seems quite con¬ 
sistent with the fundamental doctrine 
of the Lilliputian prophet - 'That all 
true Believers shall break their Eggs 
at the convenient End.' 
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Let's face it - when you need a disassem¬ 
bler you're looking for clear, reliable informa¬ 
tion. Those who have tried other products 
have been disappointed with the dismal re¬ 
sults. 


Clearly, a new standard of excellence! 

Sourcer solves these problems with ad¬ 
vanced analysis and simulation. The quality 
of output is so good that most DOS EXE & 
COM files and drivers reassemble perfectly, 
byte-for-byte identical to the original! 

To make the results easier to understand 
Sourcer provides detailed and descriptive 
comments for interrupt subfunctions, I/O 
ports and much more. Sourcer even lets you 
examine encrypted and packed programs. 


mov ax,2517h 
mov dx .offset int_17h 
int 21 h 

mov dx,offset data_4 
mov ah ,9 
int 21 h 

mov dx,l9h 
mov ah,3lh 
int 


virustst endp 


int_17h_entry proc far 
pushf 

cmp al,3Fh 


_entry 

; DOS Services ah=function 25h 
; set intrpt vector al to ds:dx 
; ('Halt when ? printed.') 

; DOS Services ah=function 09h 
; display char string at ds:dx 


DOS Services ah=function 31 h 
terminate and stay resident 
al=retum code,dx=paragraphs 


; Push flags 
■'?' 


Partial Disassembly of a Vims 


C/C++ and Pascal 

Some C, C++ and Pascal developers hate 
disassembly because the source code they get is 
assembly. We can't change that, but we can 
make it easier for you by automatically identi¬ 
fying the use of parameter passing and local 
stack variables. Parameters pushed onto the 
stack prior to a subroutine call are clearly com¬ 
mented. 

Get commented BIOS listings 

The BIOS Pre-Processor creates commented 
listings for any BIOS ROM. Understand how 
your specific BIOS works! Adds over 75K of 
comments specific to your BIOS. Inserts labels 
like "int_ 10_video”. And it's fully automatic. 
Windows disassembly! 

Windows Source generates detailed listings 
of Windows EXEs, DLLs, VxDs, device 
drivers, & OS/2 NE files. Windows Source 
labels, by name, export & import function calls, 
API calls like "GetModuleHandle", undocu¬ 
mented APIs, VxD functions and much more. 

Call now! 
1 - 800 - 648-8266 


Sourcer $149.95 

Sourcer & BIOS Pre-processor 189.95 

Sourcer & Windows Source 249.95 

Sourcer, BIOS & Windows Source 289.95 


,, ia: USA $6; Canada/Mexico $10; All others $25. 

CA residents add sales tax. © 1994 VISA/MC/Amex/COD 

30-DAY MONEY-BACK GUARANTEE 
V Communications, Inc. 

4320 Stevens Creek Blvd., Suite 120-WD 
San Jose, CA 95129 408-296-4224 
FAX 408-296-4441 
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Hard-to-find titles and titles you won’t find anywhere else 

Windows ■ DOS ■ PC Hardware ■ Visual Basic - C++ 



Karen Hazzah 


Writing 
Windows VxDs 

and Device Drivers 


Complete Source Code Included 


Writing Windows VxDS and Device 
Drivers 

By Karen Hazzah 

Karen Hazzah explains the full range of 
alternatives for interfacing Windows 
applications to hardware, from the 
simplest DLL (Dynamic Link Library) or 
TSR to complex VxDs (Virtual Device 
Drivers). Karen shows how to write a 
VxD without burying the reader in 
Windows trivia and API references. This 
book is not for the beginner. These 
techniques require knowing assembly 
language, C, and DOS, especially direct 
calls to DOS using interrupt INT21. 

R&D Publications, 1995, 350 pp. 

ISBN 0-13-100181-7 

T59C with disk.$49.95 


WILLIAM SMITH 

n 

ROBERT WARD 

RM 
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V. 


WINDOWS 

CUSTOM 

CONTROLS 


Windows Custom Controls 

By William Smith & Robert Ward 

This book demonstrates how to make 
powerful and usable custom controls for 
Microsoft Widows. The openness of the 
Windows programming environment 
allows the developer a wide range of 
options. Smith & Ward show how to 
exploit this creative opportunity with a 
modular technique that brings structure 
and reusability to Windows application 
designs. Reusing the custom controls 
allows you to focus on the larger design 
issues. 

R&D Publications, 1993, 531 pp. 

ISBN 0-13-034497-4 

W99S with disk.$55 



system programming 


29 Peart* tor DOS Programmers 

edited by 

David Burki 
Robert Ward 



MS-DOS System Programming: 

Third edition 

Edited by David Burki & Robert Ward 

Veterans and beginners will all find 
something in this collection to save time 
and program MS-DOS more efficiently. 
Some of the updated chapters include 
critical error handling, modifying the DOS 
boot, interrupt-driven serial I/O, TSRs, 
accessing the global environment, and 
interfacing to the floppy disk controller. 
New chapters include serial 
communications, the floating point 
coprocessor, CD-ROM drivers, Direct 
Memory Access, and the PC speaker. 
Each chapter gives complete details and 
can be read independently. The 
companion disk includes all the code. 

R&D Publications, 1994, 811 pp. 

ISBN 0-13-207382-X 



Building 

Remote Procedure Celle 
lor Windows NT Networks 


RPC for NT 

By Guy Eddon 

RPC for NT shows how to harness the 
power of distributed computing on a PC 
network with a Windows NT server. Guy 
Eddon provides a step-by-step guide to 
developing Remote Procedure Calls. He 
explains standards and requirements, 
how RPC is related to other parts of 
Windows, and how to use RPC with 
parallel processors, multiprocessors, and 
transputers. Use RPC to solve problems 
in a fraction of the time it would take a 
single machine. 

R&D Publications, 1994, 427 pp. 

ISBN 0-13-100223-6 

T58C with disk.$39.95 


V36 with disk. 


$39.95 


You may FAX your order to 913-841-2624 or 
e-mail it to rdorders@rdpub.com 

All orders must be prepaid in US dollars by check, money order, 
or credit card—MasterCard, VISA, and American Express are accepted. 


FREE 1994 R&D Technical Book Catalog 

R&D publishes advanced programming books, as well as 
C/C++ Users Journal and Windows/DOS Developer’s 
Journal. Get your complete catalog of R&D programming 
books, along with descriptions of more than 150 useful 
books from a dozen different publishers. 

CALL TODAY — 913 - 841 - 1631 . 

Or, use the Reader Service card in this magazine. 
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Books in Brief 

First Impressions of Recent Titles 


Ron Burk 


Unauthorized Windows 95 
Andrew Schulman 
611 pages 

$39.99, with CD-ROM and 3.5" diskette 
IDG Books Worldwide, 1994 
ISBN 1-56884-305-4 



Webster's defines a polemic as "an aggressive attack 
on or refutation of the opinions or principles of another,' 
and that is a good description of this book. The opinions 
being refuted are essentially broad technical charac¬ 
terizations of Windows 95, ground out by the Microsoft 
propaganda machine and repeated in various forms by 
the trade and technical press. Does Windows 95 com¬ 
pletely bypass DOS? Is Windows 95 closer to Windows NT 
than it is to Window 3.1 ? Is Windows 95 a much more 
integrated operating system than Windows 3.1? I think 
this book pretty convincingly shows that the answer to all 
these questions is 'not really." 

The book is not just a polemic, however. As it trundles 
down various back alleys of Windows 95 in search of an¬ 
swers to various questions about how Windows 95 works, 
it emits nuggets of information that can be crucial to pro¬ 
grammers who work in such low-level areas as device 
drivers. Keep in mind that Microsoft has never supplied 
any VxD-level design information to speak of, nor does it 
provide support for programmers who purchase the Mi¬ 
crosoft DDK. That means device driver writers will pur¬ 


chase this book, if for no other reason than that they 
have to purchase any books that can help fill in the large 
gaps (larger now that Windows 95 brings more undocu¬ 
mented behavior to the table) of programming knowledge 
about this topic. If you like disassembly, dumps, and learn¬ 
ing how Windows works by spying on interrupts, this 
book is for you. On the other hand, if you're not comfort¬ 
able with PSPs, TDBs, assembly language, low-level debug¬ 
ging, and protected-mode programming, this is probably a 
good book to avoid. 

More than one programmer I've talked to after reading 
this book has voiced comments like "OK, so DOS isn't 
completely gone, so the Win32 kernel does rely on the 
Win16 kernel - what's the big deal?" I agree that the 
book can get repetitive in its refutation of key points. 
However, I'm reluctant to conclude that such a refutation 
of existing depictions of the Windows 95 architecture is 
not worthwhile, mostly because of lessons from the past. 
In particular, I remember the debacle of large memory 
model programming under Windows. Medium memory 
model programming, requiring precise incantations of far 
and near and other programming convolutions, was no 
longer needed or even appropriate for many programs af¬ 
ter Windows 3.0 came out; if you had a compiler that 
could avoid generating multiple data segments, you could 
pretty much use the large memory model and write nor¬ 
mal, even somewhat portable code. Unfortunately, Mi¬ 
crosoft's compiler did not have that simple ability, and Mi¬ 
crosoft helped encourage the view that this was a limita¬ 
tion of the operating system, rather than the compiler. 
The Microsoft Press book Programming Windows 3.0 (and 


Cot an opinion about these or other programming books? Send them to 70302.2566@compuserve.com. You can order any of the 
books that appear in Books in Brief from Miller Freeman, Inc. by calling (913) 841-1631, faxing (913) 841 -2624, or sending email to 
rdorders@rdpub.com. if using fax or email, send the book title, author, and publisher along with your MasterCard or Visa number, 
expiration date, and phone number. 
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even the Windows 3.1 edition) reinforced this myth by re¬ 
taining an emphasis on using the medium memory 
model. As a result, to this day there are programmers 
struggling to use the medium memory model only be¬ 
cause they have the vague idea that there are 'some 
problems' with using the large memory model. This is a 
perfect example of how the propagation of a flawed un¬ 
derstanding of the operating system can waste untold 
hours of programmer time. So despite the drawbacks of a 
technical book that takes the form of a polemic, I feel 
Unauthorized Windows 95 provides much-needed balance 
to the technical model of Windows 95 that Microsoft has 
propagated so far. 


Inside Windows 95 
Adrian King 
505 pages 
$24.95 

Microsoft Press, 1994 
ISBN 1-5561 5-626-X 


This book is the Microsoft-authorized description of 
Windows 95. The book has the classic flaw of program¬ 
ming books: lack of focus. It tries to 
cover both high-level aspects of Win¬ 
dows 95, such as the user interface 
and the shell, and certain very nar¬ 
row technical depths, such as the as¬ 
sembly language output of the thunk 
compiler (if you need yet another 
book that describes how 80386 page 
tables work, it's got that too). 
Strangely, the one advantage that a 
Microsoft-authorized book ought to 
have - the benefit of an extremely 
thorough technical review - seems 
to have been omitted, and the book 
has already garnered a reputation for 
inaccuracy (even in nontechnical ar¬ 
eas, such as claiming that Microsoft 
gives out 16 VxD IDs at a time, 
which hasn't been true for years). 

inside Windows 95 is ultimately a 
marketing tool for Microsoft, so you 
will get to read the party line on 
both technical and strategic issues. 
The inability to predict which year 
the product will ship is not a failure 
on Microsoft's part, but rather a prob¬ 
lem 'beyond human ability.' You can 
chuckle when you read that Bill 
Gates 'committed" to a Windows 95 
release before the end of 1994, and 
about the company's goal of making 
Windows 95 run as well as Windows 
3.1 in 4Mb of memory on a 386SX. 
The book concludes with a vapid in¬ 
terview with Microsoft vice presidents 
Paul Maritz and Brad Silverburg, and 
the author's dogged questioning 
leads to revelations such as "I love 
the product. I'm so in love with this 
product.' It's too bad Microsoft didn't 
commission two books: one that was 
purely to sen/e their marketing de¬ 
partment, and one that was an in- 
depth technical description of the de¬ 
sign of Windows 95, free of hype. 
This book works fine as an overview 


Rev Up Database 
Programming 

with Greenleaf Database Library 



Powerful Functions 


□ The SoftC Database Library 
is now the new Greenleaf 
Database Library. 

□ Unsurpassed speed and 
flexibility for access to 
industry standard database 
data, index, and memo files 
at an affordable price. 

□ Databased Advisor says, 

"SoftC Database Library has 
top ratings!" 

□ Don't be fooled by pretty 
ads—the Database Library is 
all you need to interface 
with dBASE III, dBASE IV, 
FoxPro, FoxBASE, Clipper, 
dBXL, and other xBASE files 
including new FoxPro CDX 
index files. 

□ Supports MS-DOS, 
Windows™, and is portable 
to OS/2, UNIX. 

□ Includes Windows 3.1 DLL, 
supports Microsoft, Borland 
and Zortech C/C++. 

□ Single and Multiple User; 
Network acccess fully 
supported. 

□ Database package not 
required—this product is a 
complete ISAM library. 

□ Windows DLL linkable with 
most DLL-capable compilers 
(including Visual Basic). 


All Greenleaf Libraries Feature: 

□ No royalties 

□ 90-day money-back guarantee 

□ FREE unshrouded source (ANSI & K&R) 

□ FREE unlimited tech support 

□ Top rated documentation AND online 
documentation with FREE help engine! 

□ FREE BBS access, quarterly newsletter 

□ GOLD support available: toll-free access to 
BBS, tech support and free updates—call for 
prices 

Database Library v3.22 .. $249 

■a* Call today for complete infor¬ 
mation, demo, or to order. Mas¬ 
terCard, VISA, AmEx, approved 
purchase orders. 

1 - 800 - 523-9830 

214-248-2561 
FAX 214-248-7830 
BBS 214-250-3778 

Greenleaf Software, Inc. 

16479 Dallas Parkway, Suite 570 
Dallas, TX 75248 

ill 

GREENLEAF 
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of Windows 95 for technical manag¬ 
ers, but it is too incomplete and inac¬ 
curate in its details to serve as a 
good reference for programmers. Buy 
one copy for your programming 
team and pass it around; a single 
quick read should suffice. 

Books Received 

William Stallings. Operating Systems , 
2nd Edition. 720 pages. $61.00. 
Prentice Hall, 1995. ISBN 0-02- 
415493-8 

An updated look at operating sys¬ 
tem theory and practice, with ex¬ 
amples drawn from Windows NT, 
UNIX, and MVS. 

Joe Gradecki. NetWarriors in C. 448 
pages. $34.95, includes CD-ROM. 
John Wiley a Sons, 1995. ISBN 0- 
471-11064-7 

Programming 3D multiplayer 
games using an existing ray-cast¬ 
ing engine (ACK3D); includes 
plenty of pages of code and 
white space. 

Lee Hudspeth and Timothy-James 
Lee. The Underground Guide to Mi¬ 
crosoft Office, OLE, and VBA. 350 
pages. $24.95. Addison-Wesley, 
1995. ISBN 0-201-41035-4 
All about integrated solutions 
with Microsoft Office. 

David M. Papurt. Inside the Object 
Model. 540 pages. $39.00. SIGS 
Books, 1995. ISBN 1-884842-05-4 
A guide to 'the sensible use of 
C++,' written in a somewhat aca¬ 
demic style, but with many small 
code examples. 

Lets Talk Books 

Sb: January Books in Brief 
Fm: Richard Masson [73743,1343] 
Dear Ron, 

I enjoyed your 'Books in Brief 
column in January's W/DDJ, you sure 
didn't pull any punches! Your com¬ 
ment on the 'Microsoft seal of sub¬ 
mission' had me laughing out loud. 
As I have a copy of Kruglinski's Inside 
Visual C++ and agree that the book is 
short on focus, I wanted to ask if you 
could recommend any better books 
on MFC and Visual C++ 1.5. I'm rela¬ 
tively new to C++, and I'm concen¬ 
trating my efforts on learning MFC. 
Thanks for your help. 


Regards, 

Richard Masson 

I'm glad you enjoyed the column. Al¬ 
though I did not conclude that Kruglin¬ 
ski's book was great, so far it is the best 
Visual C++ book I have found. I'll keep 
looking, though. I have not been del¬ 
uged with mail from readers pointing to 
their favorite Visual C++ book, so per¬ 
haps the best book has yet to be written. 
I did discover that the documentation for 
MFC that ships with Visual C++ 2.0 has 
more and better conceptual MFC infor¬ 
mation than any of the books I looked 
at Also, for general C++ programming, 
a number of decent books are out. Check 
out books by Stroustrup (The C++ Pro¬ 
gramming Language, 2nd Edition), 
Lippman (A C++ Primer), and after you 
get a bit of practice writing classes, books 
by Meyers (Effective C++) and Murray 
(C++ Strategies and Tactics), -rib 

Ron, 

Just wanted to drop you a quick 
line and thank you for your review 
of The Visual C++ Construction Kit, 
which I co-authored, along with Jack 
Tackett, Jr. You may be surprised to 
find that we agree with your criti¬ 
cisms of our book; for example, the 
paucity of diagrams was a deliberate 
'design consideration' on my part. 
Thanks to your review, we feel we've 
learned something and can make 
our next work better. As for the other 
shortcomings of the book, we feel 
these are due to difficulties enoun- 
tered with the publisher, and beyond 
our control. And, after all, we are 
programmers who write, and not 
vice-versa! 

Again, thanks for telling it like it is 
- the job of a critic cannot be easy, 
and we salute you for a job well 
done. 

Cheers, 

Keith E. Bugg 

It was very nice of you to write. I 
think the fact that most technical book 
reviews are quite uncritical tends to 
make all critical ones seem negative. In 
fact, I intended the review of your book 
to be mixed, not just negative. The con¬ 
cept of presenting lots of task-oriented 
information was definitely a good one, 
and the book is head and shoulders 
above several others I looked at. 


FrontRunner. 
Think of it as a 

WINDOWS 

EXTENDER. 


Tired of how Windows falls 
short when you’re running 
DOS applications? Then use 
Phar Lap® FrontRunner,® the 
programmer’s dream shell. 
You'll add command-line 
power to Windows, plus lots 
of goodies that put you in 
ultimate control. 


SCROLLABLE SCREEN HISTORY 


Review your 
entire DOS session, up to 
16,000 lines. No more vanish¬ 
ing error messages. 


UNIVERSAL COPY & PASTE 


Just highlight 
& click from D0S/D0S, 
DOS/Windows, Windows/DOS. 


COMMAND-LINE SPEED 


Run DOS or 
Windows programs right from 
the DOS prompt. 


CUSTOMIZABLE LAUNCH BAR 


Speed-launch 
your favorite applications 
using buttons or the Run 
Menu. No Program Manager 
clutter. 


AND LOTS MORE 


Programmable 
Status Bar, visual batch lan¬ 
guage extensions, and more! 

Phar Lap FrontRunner 

Windows, the way 
programmers want it. 


'The perfect 
shell for the 
Windows shell" 
- Datamation, 
June 1994 



ORDER NOW! Only S99 

1 800 292 9622 

30-day money-back guarantee 


Phar Lap Software, Inc. 

60 Aberdeen Avenue, Cambridge, MA 02138 
TEL 617 661-1510 Fax 617-876-2972 

Phar Lap and FrontRunner are registered trademarks of 
Phar Lap Software, Inc. Windows is a trademark of Microsoft Corp. 
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SDK Annotation #68 


Windows 3.1 SDK 


File Edit Bookmark Help 


Conlenl. j gea.ch j Jack | ...Hpifflt,.J—&<-i.^.i jte._LfeS»gJa!S^ 


DRAWITEMSTRUCT (3.0) 


& 

typedef struct tagDRAUITEMSTRUCT { 
UINT CtlType. 

UIKT CtllD, 

UINT itemID. 


/* ditm */ 


Annotation: 


The itemID field in this structure is set to a negative value for an 
empty listbox or combobox. Watch out. though -- since this field is 
defined to be unsigned (UINT). a statement like this: 

if(lpdis->itemlD >= 0) // if listbox not empty 
// ... some code 

will always evaluate true To check for an empty listbox or 
combobox. either cast the field to int or check the high bit: 

if( (int) lpdis->itemlD > = 0) // this works correctly 
//... some code 

Submitted by Aaron O'Neil. 

(SDK Annotation == free T-shirt! Send your idea to 
70302.25G6@compuserve.com. Get complete annotation file from 
locations listed in table of contents, or file sdkann.zip from Library 7 
(RiD Publications) of forum SDFORUM on CompuServe ! 


&»V« j 


Cancel j 

fielete I 


Copy 


Eatle 


I once considered inviting past and 
current programming book authors to 
send me their favorite publisher horror 
story, but I decided that might be open¬ 
ing a floodgate. I've heard of publishers 
requesting that good-sized, highly techni¬ 
cal books be completed within four 
months from start to finish, and I've 
heard of publishers instructing authors to 
"pad with code" to meet specific page 
counts, and those are only some of the 
less horrible stories that have come my 
way. Still, publishers have their own 
unique set of problems, and we can all 
but try to improve over time. Thanks for 
writing and I look forward to seeing your 
next book (or magazine article!), -rib □ 



Put a “Windows face”on 
anybody’s DOS application. 

No modification to source code required. 

Create, using virtually any Windows development language, a 
Windows interface for your hardworking, dependable DOS and host 
legacy application. 

From Windows applications, send keys to and read screens from any 
application running in a DOS box. Also manage DOS tasks like 
scheduling, priorities and window status; and DOS output redirection. 

Now, for the first time ever, use RobinHood’s 40-function API, 
Windows DLL and VxD communications pipeline, and the Windows 
development weapon of choice to create Windows front-ends for 
anybody’s DOS or host programs. Or create real-time EIS systems 
for managers who depend on DOS data using Windows report 
writers or spreadsheet macro languages. 

Put on a happy (Windows) face. It‘s surprisingly easy. 


The 


RobinHood 


Also ask about our 

WINGate Developer's 
Toolkit: 

Peer-to-peer and client/servei: 
teal time VxD-based'btier- 
pmcesscamminicatioris 
betweenVMs. 

WINGate Technologies, High Street Court, Suite 303, Morristown, NJ 07960 
1-800-946-4283 • 201-539-2727 • Fax 201-539-2838 


Developer’s Toolkit 
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Solving the Pentium FDIV 
Problem 



Terje Mathisen 


Visual C++vl .5 
Borland C++ v4.5 
Symantec C++ v6.1 
Watcom C++ vl 0.0 


I first heard about 'an interesting Pentium problem" in a private email I 
received on November 3, 1994, from Alex Wolfe, a journalist working for EE 
Times. He wanted to quote me in an article he was writing, and then men¬ 
tioned in passing: 

P.S. It's interesting this thread should come up on comp.sys.intel this week. On the 
Canopus forum in CompuServe, someone yesterday posted a message saying that 
evaluating the expression ( 1 / 824633702441 ) * 824633702441 on a 486 machine yields 
1. But on a Pentium, he claims, the result is 0.99999999627470902. 

I immediately wrote a test program and ran it under Turbo Debugger to verify 
this claim. It was then obvious that my 60MHz Pentium machine was failing 
during the division ( FDIV) stage, giving a bogus result starting from the 28th of 
the 64 bits in the extended-precision mantissa. I then ran my test program on 
a couple of 90-MHz Pentium machines, to check if this bug had been fixed in 
the newer Pentium models, but they gave the same erroneous results. 

An hour later, I made the very first Internet news (UseNet) post about this 
subject, 'Glaring bug in FDIV on Pentium,' to the comp.sys.intel (c.s.i.) news- 
group. This generated very few replies initially, but after a couple of weeks, the 
traffic exploded, to the point where it drowned ail other subjects in c.s.i. During 
the same timeframe I started looking into possible workarounds for the bug, 
and wrote a post suggesting the use of a Newton-Raphson iteration process 
(see the sidebar) to get good results. 


Terje Mathisen is a Systems Architect working for Norsk Hydro in Oslo, Norway. He is 
interested in optimized assembly programming on 486 and Pentium CPUs. He may be 
reached at Terje.Mathisen@hda.hydro.com. 
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I was then contacted by Cleve Moler, the founder of 
The MathWorks, who makes MATLAB, the mathemathical 
modeling software. He suggested using a different 


workaround, based on the fact that most divisions will be 
okay; for totally random pairs of numbers, the odds of 
hitting the bug are about 1 in 9 billion. His suggestion was 


Using Newton-Raphson to Improve Division 


To calculate 
z = x/y 

first rearrange the equation to 
z = x*(l/y) 

Calculate the reciprocal of y, with possibly limited preci¬ 
sion from the FDIV bug: 

(Exact value) r = 1/y 
(result from FDIV) t = r*(l+err) 

Improve the approximate value via the Newton-Raph¬ 
son algorithm: 

t = t (2-t *y) 
n+l n n 


By manipulating this equation, you can see how much 
it decreases the error component: 

= r(l+err)(2-r(l+err)*y) 

= r(l+err)(2-ry(l+err)) 

= r(1+err)(2-(1+err)) 

= r(l+err)(l-err) 

= r(l-err A 2) 

As this equation shows, each iteration of this calcula¬ 
tion gives approximately twice as many correct bits in 
the value for the reciprocal, so starting with 27 bits 
after FDIV, a single iteration would give (about) double 
precision, and one more would put it, at most, one bit 
away from the real value. With the final multiplication 
step, this would give a result that was normally the 
correct one, and never more than 2 units in the last 
place (ulp) away, due to rounding errors. □ 
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Listing 1 p87test.asm — Code to detect Pentium bug 


.model tiny 
.data 


bug2_l dd 
bug2_2 dd 
bug2_diff dt 
bug2_log dw 


4195835 

3145727 

? 

64 


feature_bits dd ? 


cpujnsg dw 
ndp_msg dw 


I808x$. 1186$, 1286$, 1386$, 1486$, cpuid5$ 
No87$. 18087$, 1287$, 1387$ 


featurejist dw fpu$, 
dw mce$, 


vme$, 

cx8$ 


iobrk$, pse$, tsc$, p5msr$, 


cprt 

db 

'Pentium FDIV bug finder. VI.2 (c) ' 


db 

'Terje Mathisen 1994', 13,10,13,10,'$' 

I808x$ 

db 

'This is an 808x cpu',13,10,'$' 

1186$ 

db 

'This is a 186 cpu',13,10,'$' 

1286$ 

db 

'This is a 286 cpu',13,10,'$' 

1386$ 

db 

'This is a 386 cpu',13,10,'$' 

1486$ 

db 

'This is a 486 cpu',13,10,'$' 

cpuid5$ db 

'This is a Pentium or better cpu',13,10,'$' 

No87$ 

db 

'It has no ndp!',13,10,'$' 

18087$ 

db 

'It has an 8087 ndp',13,10,'$' 

1287$ 

db 

'It has a 287 ndp',13.10.'$' 

1387$ 

db 

'It has a 387 or later ndp',13,10,'$' 


feature_msgl$ db 13,10.'CPU feature list:',13,10,'$' 


' 1 : FPU (NDP) onchip',13,10,T 
' 2 : Virtual 86 Mode Extensions'.13,10,'$' 

' 4:1/0 Breakpoints',13,10,'$' 

' 8 : Page Size Extensions',13,10,'$' 

' 10 : Time Stamp Counter',13,10,'$' 

' 20 : Pentium style Model Specific Registers' 

13.10, '$' 

' 80 : Machine Check Exception',13,10,'$' 

'100 : CMPXCHG8B instruction available' 

13.10.13.10, '$' 


earlyP5$ db 'This is an early Pentium, with only partial 
db 'CPUID support!'.13,10,'$' 


fpu$ 

db 

vme$ 

db 

iobrk$ 

db 

pse$ 

db 

tsc$ 

db 

p5msr$ 

db 


db 

mce$ 

db 

cx8$ 

db 


db 

featurejnsg 


cpuid_result$ 

db 13,10,'CPUID reports back:',13,10 

db 

'Vendor id = ”' 

vendor_id dd 

3 dup (?) 

db 

'"'.13,10 

db 

'Family (4=486, 5=Pentium etc.) = ' 

make$ dw 

'00' 

db 

', model = ' 

model $ dw 

'00' 

db 

', stepping = ' 

step$ dw 

'00' 

db 

13,10,'$' 

fdiv_msg$ db 

13,10,'FDIV returns with ' 

fdiv_bits$ dw 

'00' 

db 

' bits resolution: $' 


FPU_bug$ db 

'It has the FDIV bug!',13,10 

; db '(1/8246337024491*824633702449 is not approximately 

: equal to 1!'.13.10.'$' 

db '4195835 - (4195835/31457271*3145727 should have 

db ' been 0, not 256!',13,10,'$' 

FPU_0K$ db 

'It does not have the FDIV bug!',13,10,'$' 

stepping db 

? 

CPUModel db 

? 

Cpu_Type db 

? ; 0,1,2,3,4,5 etc 

Ndp Type db 

? ; None, 8087, 287, 387+ 

have_cpuid db 

0 

Notp5$ db 'The 

FDIV bug occurs only on Pentium cpusl',13,10 

.code 

org 

100h 

start proc 

far 

lea 

dx,[cprt] 

mov 

ah,9 

int 

21h 

call 

getcpu 

mov 

bl.[cpu type] 

cmp 

bl ,5 

jbe 

@@ok 

mov 

@@ok: 

bl ,5 

xor 

bh.bh 

add 

bx.bx 

mov 

dx.cpu msg[bx] 

mov 

ah,9 

int 

21h 

test 

[have_cpuid],-l 

jz 

no_cpuid 

mov 

bx, word ptr [feature_bits] 

mov 

ax, word ptr [feature_bits+2] 

or 

ax,bx 

lea 

dx,[earlyP5$] 

jz 

dispMsg 

: Full CPUID support on this cpu, report back what we found 

mov 

al,[cpu_type] 

call 

twodig 

mov 

[make$],ax 

mov 

al,[CpuModel] 

call 

twodig 

mov 

[model$],ax 

mov 

al.[stepping] 

call 

twodig 

mov 

[step$],ax 

lea 

dx,[cpuid result$] 

mov 

ah.9 

int 

21h 

: Display feature bits definitions: 

lea 

dx.[feature msgl$] 

mov 

ah,9 

int 

21h 

lea 

si .[featurejist] 

mov 

cx,9 ; Nr of currently defined feature bits 

mov 

di.word ptr [featurejaits] 
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to do the division normally, and then multiply back and 
compare with the original number to see if the results 
matched within the possible rounding errors. In case of a 
division failure, he suggested scaling both numbers by a 
factor (3/4) that was the simplest possible that would re¬ 
arrange the mantissa bitpatterns, then retrying the opera¬ 
tion. We wrote code to implement his idea, but while test¬ 
ing, we realized that it would be very hard to support all 
the possible special cases (+/-infinity, denormal and inva¬ 
lid (NaN) numbers, etc.) A few days later, Tim Coe, of 
Vitesse Semiconductor, joined our two-man team. Tim had 
been able to reverse-engineer the algorithm used in the 
FDIV hardware by working from a list of numbers people 
on the Internet had found that failed. 

On the basis of his model of the Pen¬ 
tium divider, we decided to use a to¬ 
tally new algorithm. 

Pentium Division Hardware 

The Pentium uses a radix-4 SRT 
(named after its inventor's initials) di¬ 
vider, to be able to generate two bits 
of the result during each iteration 
(clock cycle). This process uses a 
lookup table to predict the next two 
bits based on the first few bits in the 
denominator and the leading bits in 
the current remainder of the numera¬ 
tor. The error is caused by five miss¬ 
ing borderline entries in this lookup 
table, where the hardware returns 0 
instead of 2. To be able to hit these 
holes, the first four fractional bits (af¬ 
ter the leading bit, which is always 7), 
must contain a nibble value equal to 
either 7, 4, 7, 70, or 73. 

Next, since the holes are located 
at the edge of the table, Tim was 
able to prove that the denominator 
must also have a number of consecu¬ 
tive 1 bits, following one of those 
five 'magic' nibbles. Given this infor¬ 
mation, we decided to inspect the de¬ 
nominator before doing any FDIV op¬ 
eration, and if the bit-pattern was 
such that it could fail, scale both 
numbers with a value (15/16) that 
would move any number inside one 
of the error ranges out of the range, 
without moving it far enough to hit 
the next hole in the table. 

At this point a team from Intel 
joined our informal working group to 
finalize the workaround and to con¬ 
tact all the compiler vendors, who 
could then embed the patch code 
when (re-)compiling programs. This 
works by replacing each FDIV nor¬ 
mally generated by a macro that sub¬ 


stitutes the workaround code. Tim Coe and Peter Tang 
(who consulted with Intel on the transcendental functions 
in the Pentium) were independently able to prove that at 
least three 7 bits were needed to hit the holes. This is the 
basis for the current (first) version of the Intel-approved 
patch. Later Tim and Peter, working together, were able to 
prove that six 7 bits are needed to be at risk of hitting the 
bug, and while trying to prove another couple of bits, Tim 
found counterexamples, so six is the limit. 

Intel Pentium Recall 

On December 20, 1994, Intel issued a general replace¬ 
ment statement, saying that anyone who wanted a cor- 
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@@next feature: 


int 

21h 

shr 

di.l 



jnc 

@@skip_feature 

lea 

dx.[FPU_0K$] 

mov 

dx.[si] 

cmp 

byte ptr [bug2_log].62 

mov 

ah,9 

jae 

@@disp bug 

int 

21h 

lea 

dx.[FPU_Bug$] 



@@disp_bug: 


@@skip_feature: 


mov 

ah.9 

add 

si ,2 

int 

21h 

dec 

cx 



jnz 

@®next feature 

exit: 




mov 

ax,4c00h 

lea 

dx,[feature_msg2$] 

int 

21h : All done! 

dispMsg: 


start endp 


mov 

ah.9 



l'nt 

21h 

twodig proc 




xor 

ah.ah 

no_cpuid: 


mov 

bl .10 

call 

getndp ; Will return 0..3! 

div 

bl 

mov 

bl,[ndp_type] 

add 

ax,'00' 

xor 

bh.bh 

ret 


add 

bx.bx 

twodig endp 


mov 

dx,ndp_msg[bx] 


mov 

ah.9 

getcpu proc 

; BL returns 0.1.2... for 808x,186.286... 


int 


21h 


test bx.bx 

jz exit ; No NOP, so no NDP bug either! :-) 
call testndp 

mov al. byte ptr [bug2Jog] 

call twodig 

mov [fdiv_bits$].ax 

lea dx,[fdiv_msg$] 

mov ah. 9 
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pushf 



pop 

ax 


and 

ah.Ofh : Try to clear four upper flag bits! 

push 

ax 


popf 



pushf 



pop 

ax 


xor 

bx.bx : 

Assume 808x -> BX = 0 

cmp 

ah,0f0h 


jae 

getcpu_done ; 

All four upper bits set -> 808x 

or 

ah,0f0h ; 

Try to set the upper four bits: 

push 

ax 


popf 



pushf 



pop 

ax 


and 

ah.0f0h 

; Isolate them 

mov 

bx.2 

; This is a 286! 

jz 

getcpu_done 

; Just a 286. no FDIV problem! 

*************** 3Q5+ C0 de 

******************* 

inc 

bx 

; BX = 3. for 386+ cpus 

.486 



mov 

edx.esp 


and 

esp.not 3 

; DWORD-align stack to allow AC! 

pushfd 



pop 

eax 


mov 

ecx.eax 


xor 

eax.l SHL 18 

: AC flag == bit # 18! 

push 

eax 


popfd 



pushfd 



pop 

eax 


push 

ecx 


popfd 


; Restore original eflags 

mov 

esp.edx 

; Restore word-aligned stack ptr 

xor 

eax,ecx 

; Could we toggle the AC flag? 

jz 

getcpu_done 

: No. so this is a 386! 

inc 

bx 

: BX = 4(86) 

mov 

eax,ecx 


xor 

eax.l SHL 21 

; ID flag == bit # 21! 

push 

eax 


popfd 



pushfd 



pop 

eax 


push 

ecx 


popfd 



xor 

eax,ecx ; 

Could we toggle the ID bit? 

jnz 

haveCPUID ; 

Yes, use CPUID to get more info! 


Page 44 — Windows/DOS Developer’s Journal 


August 1995 



















rected CPU, would get one, so why worry? As of the mid¬ 
dle of January 95, Intel is still producing more bad Pen¬ 
tium chips. Even with the 'no questions asked' replace¬ 
ment policy, several million buggy Pentiums will be 
around for many years, so all responsible floating-point 
software developers should make sure that their programs 
are able to handle the FDIV bug. 

At the very least, the program should test the chip dur¬ 
ing startup, and then if the bug is found, either refuse to 
run, or give a warning message, stating that floating-point 
divisions could fail. A better approach is to recompile your 
programs if your compiler vendor offers an update that 
uses the workaround. If you cannot wait for this, or if 
your compiler isn't among those offering a patched ver¬ 
sion, the only option is to modify your source code. 

Intel issued a press release announcing various vendors 
who have incorporated the floating-point software 
workaround. The list of vendors consisted of Borland (Bor¬ 
land C++ v4.5, Delphi vl.O), Cygnus Support (Gnu C 
V2.6.3), MetaWare (DOS C V3.31), Microsoft (Visual C++ 
v2.0), and Watcom (C/C++ vl .05, FORTRAN v9.5). A very 
important exception to this list is Visual C++ vl.5, Mi¬ 
crosoft's compiler for 16-bit applications. Steve Ross of Mi¬ 
crosoft confirmed that the company is not supplying an 
FDIV fix for this compiler. 

Patching Strategy 

The patch strategy is to place each floating point divi¬ 
sion operation with a function call to a subroutine that 
implements the fix. Thus, replace 

z = x/y; 
with 

z = fdiv(x,y); 


Listing 1 

continued 


; Drop through to exit for 486 case 

getcpu_done: 


mov 

[cpu_type],bl 

ret 

; Return with BX = CPU ID 

haveCPUID: 


mov 

[have_cpuid].l ; At least some CPUID support 

; Use CPUID instruction to get more info! 

xor 

eax.eax ; EAX == 0 -> Basic CPUID report 

db 

0Fh, 0A2h ; CPUID opcode! 

mov 

[vendor_id],ebx 

mov 

[vendor_id+4],edx 

mov 

[vendor_id+8],ecx 

test 

eax.eax ; Other values in EAX valid? 

Jz 

getcpu_done ; No. This is an early Pentium! 

mov 

eax.l 

db 

0Fh, 0A2h ; CPUID opcode! 

mov 

[feature bits],edx 

and 

ah,15 ; CPU Family [4(486), 5 (Pentium) etc] 

mov 

[cpu type],ah ; Save it! (Return value) 

mov 

bl .ah 

xor 

bh.bh 

mov 

ah.al 

shr 

ah.4 

and 

al ,15 

mov 

[stepping].al 

mov 

[CpuModel],ah 

.8086 


ret 


getcpu endp 


.data 


cw dw 

? 

.code 


getndp proc 


fninit 


xor 

dx.dx : DL = (N087, 8087, 287, 387+) 

mov 

bx.offset cw 

mov 

[bx],dx ; Make sure Control Word is zero! 

fnstcw 

[bx] 
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Listing 1 continued 


jmp 

$+2 

Wait for result 

jmp 

S+2 

Wait for result 

jmp 

$+2 

Wait for result 

cmp 

byte ptr [bx+l],03 

jne 

ndpdone 

NO 87 installed! 

fdisl 


Try to Disable x87 interrupts 

fstcw 

[bx] 


inc 

dx 

At least 8087 

fwait 


Wait for result from FSTCW 

test 

byte ptr [bx],80h ; DISI bit set? 

jnz 

ndpdone 

; Yes, it's a 8087 

.286 



.287 



inc 

dx 

80287 or 80387 

fldl 


1.0 

fldz 


0.0 

fdivp 

st(l), St 

1.0 / 0.0 = +Inf 

fid 

st(0) 

Duplicate 

fchs 


= -Inf 

fcompp 


Are +Inf equal to -Inf? 

fwait 


Wait for result 

fstsw 

ax 


sahf 


Status from float point cmp 

je 

ndpdone 

+Inf == -Inf => 287 

inc 

dx 

387 


.8086 

.8087 

ndpdone: 

mov [ndp_type],dl 
ret 

getndp endp 


Figure 1 shows a simple C version of the patch code. This 
does not work if your compiler puts the FPU in single or 
double precision, instead of the default extended precision 
(e.g., Watcom and others). Watcom will also fail because it 
accepts the long double type specifier, but silently converts 
it to just double, so the bit pattern in memory is different. 
To handle these and other possible problem areas, we 
had to extend the patch code quite a bit, and implement 
it in assembler. 

FPREM, FPREM1, FPTAN and FPATAN 

Some other floating-point instructions (FPREM, FPREM1, 
FPTAN, and FPATAN) depend on FDIV, so they also produce 
flawed results. FPREM and FPREM1 differ only in the way they 
round the result; both return the remainder after perform¬ 
ing a division. They are generally used only for argument 
reduction for trigonometric operations, where there is no 
problem, since pi is not at risk of hitting the bad divider 
entries. FPTAN can be replaced with a simple combination 
of FSINCOS, which returns both the sine and the cosine 
value, and a subsequent call to our error-checking FDIV 
replacement. 

FPATAN 

Fixing FPATAN arc tangent proved to be the most trou¬ 
blesome aspect of the software workaround. This is be¬ 
cause the hardware algorithm employed by the Pentium 
uses division in two different places, first to get the ratio 


DO YOU SPEND HOURS 
TROUBLESHOOTING LANs/WANs? 

MICROSOFT WINDOWS BASED • PROTOCOL ANALYZER • LAN TROUBLESHOOTING TOOL 


Observer and Analyst/Probe are Microsoft Windows based LAN 
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• STOP the finger pointing - SIMPLY isolate 
LAN problems once and for all 

• See graphical real-time long and short term 
bandwidth utilization 

• Monitor statistics by station, protocol, or 
packet size distribution 

• Auto-discover network addresses, auto-alias 
Novell names and TCP/IP addresses 

• See packet capture decodes with pre- and 
post-header filtering (color coded packets) 

• Review Ethernet and Token Ring vital sign 
displays (broadcasts, hard/soft errors, etc.) 

• Set Triggers and Alarms to activate message 
windows, captures, logs, trouble tickets, or 
exec external programs 


Filter by protocol, sub-protocol, or user 
defined sequence offsets 
Detect duplicate IP addresses 
Chart TCP/IP network usage by telnet, ftp, 
NFS, and LPD/LPR 

Fully decode TCP/IP, IPX/SPX, NetBIOS, 
NetBEUI, NetBIOS over IP, and Appletalk 
Use Netware Discoverer to map your 
Netware LAN and to chart and display 
Netware specific trend statistics 
Software-only MS Windows solution - no 
additional hardware required 
Have Ethernet and Token Ring support 
Use VxD Windows drivers for NDIS and ODI 
20% the cost of comparable products 
START using the tool that professional LAN 
administrators and consultants use 




Observer 


TM 


Observer helps you quickly pinpoint network 
trouble spots, and costs thousands less than 
expensive hardware based analyzers. 

Observer Site license - $495 

FOR A SMALL SITE - $295 


s 
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Analyst/Probe 


TM 


Call for a FREE DEMO • 800-526-7919 

© 1995 Network Instruments, LLC 612-822-2025 FAX 612-825-5647 Internet: info@netinst.com 


Analyst/Probe provides Observer functionality for multi¬ 
segment LANs and/or WANs. Probes are software-only 
background Windows programs installed on each segment. 

Analyst and one Probe - $795 

Each additional Probe - $195 
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between the two input values (X and \), and later for argu¬ 
ment reduction using the identity 

atan(a-b) = (atan(a) - atan(b)) 

/ (1 + atan(a)*atan(b)) 

where the value for b is selected by table lookup. 

Unlike FDIV, for FTAPAN there was no way to just inspect 
the input values to determine whether a given pair of op¬ 
erands might be at risk from the FDIV error, so we had to 
use a complete software replacement for this function. 
The resulting code uses extended precision for all interme¬ 
diate operations, while the Pentium hardware instruction 
has access to internal paths with a couple of extra bits of 
precision. 

This means that while on a corrected Pentium, FPATAN 
will always be less than 1 ulp (units in last place) away 
from the true result, our workaround can be up to 3 ulp in 
error, in extended precision. 

When rounding the result to double precision, how¬ 
ever, the replacement delivers results that are nearly indis¬ 
tinguishable from the true results, with a maximum error 
of 0.50146 ulp, versus FPATAN, which gives about 0.50039 
ulp. The software workaround gives about the same preci¬ 
sion as the CORDIC algorithm used by FPATAN in the 
486DX/487, 80387, and previous numeric coprocessors. 
You can obtain a copy of the official FPATAN replacement 
code from the code disk (see table of contents for avail¬ 
ability). 


Listing 1 

continued 

.data 


Sta tusWord dw 

7 

.code 


testndp proc 


finit 


; Check second calculation: 

fild 

[bug2_l] 

fild 

[bug2 2] 

fid 

st(l) 

fdiv 

st.st(l) 

fmulp 

st(l),st 

fcom 


fsubp 

st(l),st 

fstsw 

[StatusWord] 

fabs 


mov 

ax,[StatusWord] 

sahf 


jz 

Nodiff2 

fild 

[bug2_l] 

fdivp 

st(l),st 

fldl 


fxch 

st(l) 

fyl 2x 


fabs 


fistp 

[bug2_log] 

NoDiff2: 


finit 


ret 


testndp endp 


end 

start 

; End of File 
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Let Dan Bricklin Improve 
Your Applications With 
His New OverAlf DLL 




OverAII transforms 
a boring list of 
data into an inter¬ 
active environ¬ 
ment that's easy, 
intuitive, and fun 
to use! Only $495, 
with a royalty-free 
runtime! 


Dan brought life to num¬ 
bers with VisiCalc and to 
prototyping with Demo II. 
Now, with his new 
OverAII DLL, he can bring 
life to your Windows 
applications, 

OverAII displays both 
an overall view and a 
detailed view using 
bitmapped images. 


Drag your mouse on the 
overall view and the 
detailed view follows 
along smoothly, almost 
like animation. Data is 
displayed spatially as 
icons or text. New data 
items are created by drag 
and drop. 

Use OverAII as a DLL 
with C/C++, Visual Basic, 
PowerBuilder, Lotus 
Notes ViP, and more. You 
get complete control to 
create and position data 
items, change icons, 
detect mouse hits, etc. 
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Industrial Strength 
Applications! 


WIN-PROLOG - [Console) 


File Edit Search Run Options Window 


E3 


Build industrial strength applicationsforthe industry 
standard platform, Windows 3.1! Robust, intelligent 
applications which yield the full 32-bit power of your PC. 

And with LPA-PROLOG, build them the easy way: 

High level handling of dialogs, menus and graphics 
Powerful DLL, DDE and ODBC interfaces 
Compact, fast and royalty-free runtime system 

Not to mention the integrated source level debugger, 
multi file program editor, incremental and optimising 
compilers, and full Prolog predicate library. 



1 VA// - 

Il7n 

1 PROLOG 


The industrial strength compiler 
for business applications! 



Logic Programming Associates Ltd 
Phone (US Toll Free): 1-500-949-7567 

Phone: +44 101 071 2016 - Fax: +44101 074 0449 
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Figure 1 Simplified C version of patch code 


static char fdiv_bug; 


long double fdivdong double x, long double y) 

{ 

static char fdiv_risk[16] = {0,1,0,0,4,0,0,7,0,0,10,0,0,13,0,0}; 
static float fdiv_scale = 0.9375; 

static float one_shl_63 = (65536.0*65536.0*65536.0*32768.0); 


} 


if (fdiv_bug) { 

unsigned long t, *py = (unsigned long *) &y; 
do { 

t = py[l]; 

if (t & 0x80000000) { 

t A = 0x07e00000; /* Invert six bits */ 

if (t & 0x07e00000) break; /* Does not have six 1 bits! */ 
if (fdiv_risk[(t » 271-32] == 0) break; /* Not at risk!*/ 
x *= fdiv_scale; /* 15/16 */ 

y *= fdiv_scale; /* 15/16 */ 

break; 

} 

if ((t I py[0]) ** 0) break; /* divide by zero! */ 

x *= one_shl_63; /* Scale both operands by */ 

y *= one_shl_63 /* 1 « 63 */ 

} while (1); /* Restart denormal numbers! */ 


} 


return x / y; 


Testing for the Bug 

I have written a small assembly language program, 
p87test, which will test the machine it is running on and 
report the number of correct bits returned by the FDIV 
hardware. The source code is in p87test.asm (Listing 1) 
and is included on the code disk; the program is also 
available on The MathWorks ftp server ( ftp.mathmrks.corH\ 
and at several other sites. Besides the FDIV results, p87test 
also documents the previously undocumented feature bits 
returned by the new CPUID instruction, so that you can 
use the code for your own programs if you need to deter¬ 
mine the features implemented on the current CPU. 

Conclusion 

Even with the Intel free replacement offer, millions of 
existing Pentium machines with failing FDIV hardware will 
be in use for the next several years. Embedding the 
workaround code will increase the size of your applica¬ 
tions very minimally, your programs will run at very 
nearly the same speed (unless they do nothing but FDIVs), 
and you can tell your costumers that the results they get 
from your software will be correct, even on flawed cpus. 
The code disk (see the table of contents for availability) 
contains complete documentation and source code for the 
approved software patch for the Pentium floating-point di¬ 
vide problem. □ 



Windows/DOS communications software 
off the shelf! 

Hardware and Software Packages 
for DOS or Windows 

Now you can add communication capability to your Windows/DOS 
application. Gcom has protocol packages ready to install on your 
system with application program interfaces available for both DOS 
and Windows. 


Adapter cards are available with interfaces for RS232, RS422, V.35 


communications software products 
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Implementing VB Toolbars 
with bttncur.dll 

Tom Kier 


Toolbars have become a standard feature of Windows applications. A tool¬ 
bar consists of a row of graphical buttons, usually displayed across the top of 
the application window, that give the user quick access to frequently used op¬ 
erations. A menu allows the user to choose operations through text commands, 
and also provides the keyboard interface for the application. A toolbar, on the 
other hand, provides mouse shortcuts to operations, using visually indicative 
graphical images instead of text and thus improving the usability of an applica¬ 
tion. 

Unfortunately, Visual Basic does not provide a complete toolbar solution; 
you have to build our own toolbar from the other controls provided. Visual 
Basic provides an easy and efficient way to create a toolbar window, but does 
not provide an efficient way to create the toolbar buttons. Creating a toolbar is 
as simple as using a PictureBox control box that has the Align property set to 
"Align Top'. Once you have the toolbar, there are several approaches you can 
take to creating the buttons for the toolbar. 

Before I explore the different ways to create toolbar buttons, I want to re¬ 
view the proper user interface characteristics of such buttons. Many books and 
articles offer simple solutions for Visual Basic toolbar buttons, but the results 
often fall short of expectations, lacking the look and feel' of the buttons found 
in leading Windows applications. 

Toolbar Button Behavior 

There are actually two different types of buttons on a toolbar, command 
buttons and attribute buttons. Command buttons are very similar to push but¬ 
tons in dialog boxes. When the user presses a command button, its related 
action takes place. Command buttons have three states: up, mouse down 
(clicked), and disabled. 

Attribute buttons are a little more complicated. They can be 'on' or 'off' and 
are typically used to toggle an attribute of the selected item. They also show 
the state of the attribute for the currently selected item. A good example of 
attributes buttons are the bold, italic, and underline buttons found in the tool¬ 
bars of many word processors. Attribute buttons actually have six states: up, 
mouse down, down, up disabled, down disabled, and indeterminate. The inde¬ 
terminate state is used in situations where the state of the attribute cannot be 
determined from the currently selected item. For example, if the selected text 


Tom Kier is a developer for First Floor, Inc., and is a member of the development team 
that created the award-winning groupware application "Network Central ." Fie has a 
BS degree in Computer Engineering and over 10 years of programming experience. 
Fie can be reached at tkier@firstfloor.com or on CompuServe at 72632,756. 


August 1995 


Windows/DOS Developer’s Journal — Page 49 





























Listing 1 toolbar.bas — Implementing a toolbar with bttncur.dll 

Option Explicit 

Global Const COMMANDBUTTON MOUSEDOWN = \ 

(8UTT0NGR0UP_ACTIVE Or BUTTONGROUP DOWN) 

Image indices inside the standard bitmap provided 
' with bttncurr.dll 

Global Const COMMANDBUTTON_DISAB L ED = (BUTT0NGR0UP_DISABLED) 

Global Const TOOLIMAGE EDITCUT = 0 

' Attribute buttons only 

Global Const TOOLIMAGE EDITCOPY = 1 

Global Const ATTRIBUTEBUTTON UP = (BUTTONGROUP ACTIVE) 

Global Const TOOLIMAGE EDITPASTE = 2 

Global Const ATTRIBUTEBUTTON MOUSEDOWN = (BUTTONGROUP ACTIVE \ 

Global Const TOOLIMAGE FILENEW = 3 

Or BUTTONGROUP DOWN) 

Global Const TOOLIMAGE FILEOPEN * 4 

Global Const ATTRIBUTEBUTTON DISABLED = (BUTTONGROUP DISABLED) 

Global Const TOOLIMAGE FILESAVE = 5 

Global Const ATTRIBUTEBUTTON DOWN = (BUTTONGROUP ACTIVE Or \ 

Global Const TOOLIMAGE FILEPRINT = 6 

BUTTONGROUP DOWN Or BUTTONGROUP LIGHTFACE) 

Global Const TOOLIMAGE HELP = 7 

Global Const ATTRIBUTEBUTTON INDETERMINATE = \ 

Global Const TOOLIMAGEJELPCONTEXT = 8 

(BUTTONGROUP ACTIVE Or BUTTONGROUP LIGHTFACE) 

Global Const ATTRIBUTEBUTTON DOWNDISABLED = \ 

' Standard sizes for toolbar buttons and bitmaps 

Global Const T00LBUTT0N STDWIDTH = 24 

( BUTTONGROUP_DISABLED Or BUTTONGROUPJOWN Or BUTTONGROUPJ.IGHTFACE) 

Global Const T00LBUTT0N STDHEIGHT = 22 

Declare Function UIToolButtonOraw% Lib "bttncur.dll" \ 

Global Const T00LBUTT0N STDIMAGEWIDTH = 16 

(ByVal hDC%, ByVal x*. ByVal y%, ByVal dxButtonS, \ 

Global Const T00LBUTT0N STDIMAGEHEIGHT = 15 

ByVal dyButton*. ByVal hBmp%. ByVal dxBitmap%. \ 

Global Const TOOLBUTTON_STD$EPERATOR = 6 

ByVal dyBitmapl. ByVal iImage*. ByVal uState%) 

' Values for button display states. Each value is mutually 
' exclusive and contains one or more grouping bits. Each 

' ** Windows definitions used by this module 
' ** 

Type RECT 

left As Integer 

' group represents buttons sharing some sub-state in common. 


top As Integer 

Const BUTTONGROUP DOWN = &H1 

right As Integer 

Const BUTTONGROUP ACTIVE = &H2 

bottom As Integer 

Const BUTTONGROUP DISABLED = &H4 

Const BUTTONGROUP LIGHTFACE = &H8 

End Type 

Const BUTTONGROUP_BLANK = &H10 

Type POINTAPI 
x As Integer 

' Command buttons only 

y As Integer 

Global Const COMMANDBUTTON_UP = (BUTTONGROUP_ACTIVE ) 

End Type 


Windows/DOS 


U DEVELOPER'S JOURNAL 

Windows/DOS Developer’s Journal buys dozens of articles each 
year from readers like you. You don’t have to be a writer, but you 
do have to have a concrete topic of interest to other Windows 
programmers. Most of the articles we use are built around short 
(100-300 lines), reusable code that solves specific problems of 
interest to Windows programmers. The easiest way to propose an 
article topic is to send email about your idea to the editor, Ron 
Burk, via CompuServe at 70302,2566 or Internet at 


Call for Papers 

70302.2566@compuserve.com. Make sure you include an esti¬ 
mate of the number of lines of code involved. 

If you don't have access to email, you can fax your proposal to: 
Managing Editor, Windows/DOS Developer’s Journal, (913) 841-2624, 
or mail it to: Managing Editor, Windows/DOS Developer's Journal, 
1601 West 23rd St., Suite 200, Lawrence, KS 66046-2700. 

(913) 841-1631; FAX (913) 841-2624. 


Database Programming 

■ Proposals due 3 Aug 1995 
manuscripts due 14 Sep 1995 
Suggested topics: A generic C++ 
class for caching database records. 
The world’s smalledst .dbf I/O library. 
A simple, record-oriented interface to 
ODBC. 


MFC Programming 

■ Proposals due 5 Sep 1995 
manuscripts due 16 Oct 1995 

Suggested topics: Tips for reducing 
“MFC bloat” in your .exe. How to im¬ 
plement Smalltalk-style inheritance 
with MFC and OLE. Pitfalls and 
gotchas when multithreading with 
MFC. 


Windows NT 

■ Proposals due 5 Oct 1995 
manuscripts due 15 Nov 1995 
Suggested topics: Top ten reasons 
Windows 95 apps are incompatible 
with Windows NT. A C++ class to en¬ 
capsulate a many-reader, single¬ 
writer semaphore. Benchmarking 
Windows NT versus Windows 95. A 
UNIX compatibility library for Win¬ 
dows NT. 
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contains both bold and non-bold fonts, then the boldface 
attribute button should visually indicate the indeterminate 
state. Figure 1 shows a toolbar button drawn in all six 
states. Attribute buttons can also be grouped so that only 
one of the buttons in the group can be 'on' at once, as 
with a group of radio buttons in a dialog. A good example 
of this behavior is the left, center, and right justify buttons 
found in word processor toolbars. 

Another important factor in designing toolbar buttons 
is proper interaction with the mouse. The act of 'pressing* 
a toolbar button with the mouse is not complete until the 
mouse button is released. When a user clicks a button in 
the toolbar, the button appears depressed (mouse down 
state) and the following happens: 
if the user moves the mouse cursor 
off the button before releasing the 
mouse button, the image is shown 
"undepressed' (up state for com¬ 
mand buttons, previous state for 
attribute buttons). 

If the user releases the mouse button 
when the button is depressed, 
then the associated action takes 
place. 

If the user releases the mouse button 
when the button is undepressed 
(because of having moved the 
mouse cursor off the button), then 
no action takes place. 

The last thing to consider about 
toolbar buttons is that they are de¬ 
signed for mouse interaction only (al¬ 
though it is possible to associate key¬ 
board accelerators with them). Tool¬ 
bar buttons thus never have the in¬ 
put focus, never show a focus rectan¬ 
gle, and never have default button 
highlighting. This is important when 
you are considering which controls to 
use as toolbar buttons, since many of 


the picture button controls available for Visual Basic pro¬ 
vide no way to prevent showing a focus rectangle and 
default button highlighting. 

Implementing Toolbar Buttons 

The simplest way to create buttons for a toolbar would 
be to use threed.vbx to build separate controls for each 
button. However, buttons created this way will show a fo¬ 
cus rectangle and the default button highlighting neces¬ 
sary for pushbuttons in dialogs, which is not the desired 
behavior for toolbar buttons. Also, using a separate con¬ 
trol and picture for each button eats up precious system 
resources in a hurry. 


Now a Periscope hardware 
debugger is within every 
developer’s reach 

...We’re passing on recent cost 
g savings to you by lowering our 

hardware prices up to $8001 


OU 


Just push the “panic button" on the break-out switch Icomes with 
all PeriscopesI when your system locks up. 


SOFTWARE-ONLY 
DEBUGGERS for DOS, 

Windows and OS/2... 

■ Use Periscope/EM to debug real- 
mode DOS software, including applica¬ 
tions, drivers, TSRs, and interrupts. 
Run Periscope/EM from conventional 
DOS memory or extended memory. 

■ Use Periscope/32 to debug system- 
level software running under Windows 
3.x, Windows 95, OS/2 2.x, or your 
own 32-bit operating environment. 



ADD REAL-TIME 

HARDWARE when you 
need the power of an ICE... 

■ The Periscope Model IV hardware 
adds the power of an ICE to both 
Periscope/EM and Periscope/32. Debug 
hardware interrupts, communications 
software, real-time software, and in any 
situation where you need zero slow¬ 
down, no-impact tracing or monitoring. 

■ Rent a full-blown Model IV for only 
$350 per month. 


NEW EMBEDDED SYSTEMS SUPPORT FOR 
386s and 486s... CAU FOR DETAILS! 


CALL TOLL-FREE 800/722-7006 


PERISCOPE 


® 


1475 PEACHTREE ST. f SUITE 100 • ATLANTA, GA 30309 USA 
404/888-5335 • FAX 404/888-5520 • FAXNOW 404/888-5344 


Figure 1 The six possible 
states of a toolbar button 
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See What an NT Server 
Can Really Do! 



Range 

1 computer (sec.) 

4 computers (sec.) 

Ratio 

1 -1.000 

35 

40 

0.88 

100.000- 101,000 

40 

42 

0.95 

1.000.000-1.001.000 

100 

61 

1.64 

10,000,000- 10,001,000 

581 

170 

3.42 


RPC for NT 


by Guy Eddon 

RPC for NT shows you how to write a 
distributed application using the Remote 
Procedure Call model, a powerful 
technology that allows server and clients to 
share not just data files but CPU cycles. 

Using Microsoft’s RPC implementation, an 
NT server and clients running MS-DOS, 
Windows 3.1, Windows for Workgroups, or 
Windows NT can work together to solve a 
complex problem in a fraction of the time it 
would have taken a single machine. 


Build Remote Procedure Calls 
from basic to sophisticated 

Guy Eddon guides you from a simple "Hello 
World" RPC application through a series of 
increasingly demanding programs that 
encompass all aspects of remote procedure calls. 
You’ll learn about: 

■ Implicit and explicit binding procedures 

■ Structured exception handling 

■ Multithreaded servers 

■ The RPC name service 












































Another approach is suggested in the Visual Basic Pro¬ 
grammer's Guide: use an image control for each button in 
the toolbar and then set the picture of the image control 


to show the button. The advantage of this approach is 
that you can control the exact appearance of the buttons 
and avoid the problems of focus rectangle and default 


Listing 1 continued 


Type msg 

' ** 

hWnd As Integer 

' ** Private Data for ToolBar module 

message As Integer 


wparam As Integer 

1Param As Long 

Type ToolBa rButtonlnfo 

time As Long 

ID As Integer 

pt,As POINTAPI 

Index As Integer 

End Type 

rc As RECT 

bAttributeButton As Integer 

Const WM LBUTTONUP = &H202 

state As Integer 

Const WM MOUSEMOVE = &H200 

End Type 

Const WM MOUSEFIRST = &H200 


Const WM MOUSELAST = AH209 

Const TOOLBARJORDER = 2 

Const PM REMOVE = 1 



Dim Toolbar As PictureBox 

Declare Sub GetCursorPos Lib "User” (IpPoint As POINTAPI) 

Dim ToolBarButtonsO As ToolBarButtonlnfo 

Declare Sub ScreenToClient Lib "User" Alias "ScreenToClient") 

Dim ToolBarButtonlndex As Integer 

(ByVal hWnd As Integer. MyPoint As POINTAPI) 

Dim hToolBarBitmap As Integer 

Declare Sub ClientToScreen Lib "User" \ 

Dim ToolBarlmageWidth As Integer 

(ByVal hWnd As Integer, IpPoint As POINTAPI) 

Dim ToolBarlmageHeight As Integer 

Declare Function SetCapture Lib "User" (ByVal hWnd%) \ 

Dim ToolBarNumButtons As Integer 

As Integer 

Declare Sub ReleaseCapture Lib "User" 0 

Dim ToolBarButtonWidth As Integer 

Dim ToolBarButtonHeight As Integer 

Declare Function PeekMessage Lib "User" (lpMsg As msg. \ 

Function POINTAPItoLong (pt As POINTAPI) As Long 

ByVal hWnd As Integer, ByVal wMsgFi1terMin As Integer, \ 

ByVal wMsgFilterMax As Integer, \ 

' Helper routine to convert POINTAPI routine to a long 

ByVal wRemoveMsg As Integer) As Integer 


Declare Function PtlnRect Lib "User" (IpRect As RECT, \ 

POINTAPItoLong = pt.x + CLng(pt.y) * &H10000 

ByVal ptRect As Any) As Integer 

End Function 


Integrate Your DOS Applications 
With Windows Using 




Add Graphs, Dialog Boxes and 
Clipboard support to your DOS 
applications. 
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Extend your 
DOS 

applications 
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them with 
Windows 
applications. 
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Clipper, FoxPro, 
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files. 
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CREATE Oil’s WITH VISUAL BASIC 


Visual DLL 

^ »] 'A *•!!] I 

© Do things that can’t be done with VB. 

© Split up large VB applications into smaller, 
mote manageable components. 

© Protect source code by delivering DLL’s. 

© Visual Basic’s p-code interpreter is used to 

execute DLL’s so VB compatibility is guaranteed! 

© Can be called from C, VB, dBase, Excel, Word, etc.., 
© Supports multiple user-defined parameters. 

K simply makes things easier. 

eg 



CompuServe GO S1MSOL E-mail to 74777, 3221 or internet 
at simply^netcom.com for more info, or write or call us! 



cj.n mass, 


SIMPLY SOLUTIONS 

3337 South Bristol, Suite 143 
Santa Ana, CA 92704 
phone (310) 575-5047 
fax (714) 863-1546 
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Listing 1 continued 


Function ToolBarOepressButton 0 As Integer 
' Determines which toolbar button (if any) was presssed. 

' Call this function in the toolbar mouse down event. 

' Parameters: 

' return value - the button index of the button that was 
' pressed. Zero if not button pressed. 

Dim Buttonlndex As Integer 
Dim pt As POINTAPI 
Dim message As msg 
Dim bDepressed As Integer 
Dim bToolBarCapture As Integer 
Dim Upstate As Integer 
Dim DownState As Integer 
Dim NewState As Integer 
Dim i As Integer 
Dim ec As Integer 

' Get current position of the mouse pointer in pixels 
Call GetCursorPos(pt) 

Call ScreenToClientdoolbar.hWnd. pt) 

' First find the button (if any) that is under the mouse 
Buttonlndex ■ 0 

For i = 1 To ToolBarNumButtons 

If PtlnRectdoolBarButtons(i).rc. \ 
POINTAPItoLong(pt)) Then 
Buttonlndex = i 
Exit For 
End If 
Next i 

If Buttonlndex > 0 Then 


' If button is disabled then leave 
UpState = Tool BarButtons(Buttonlndex).state 
If (UpState And BUTTONGROUP.DISABLED) <> 0 Then 
ToolBarDepressButton ■ 0 
Exit Function 
End If 

' Draw button in down state 
If ToolBarButtons(Buttonlndex).bAttributeButton Then 
DownState = ATTRIBUTEBUTTON_MOUSEDOWN 
Else 

DownState = COMMANDBUTTOH_MOUSEDOWN 
End If 

bDepressed = True 

Call ToolBarDrawButton(ButtonIndex. DownState) 

' Capture the mouse 

bToolBarCapture * True 

ec * SetCapture(Toolbar.hWnd) 

' Wait until the mouse button is released 
While (bToolBarCapture) 

If PeekMessagetmessage, Toolbar.hWnd, \ 

WM_MOUSEFIRST, WM_MOUSELAST, PM_REM0VE) Then 
Select Case message.message 
Case WM.LBUTTONUP 

' Check to see if mouse is still over 
' button and release the mouse capture 
bDepressed « PtInRect(ToolBarButtons\ 
(ButtonIndex).rc, message.lParam) 
Call ReleaseCapture 
bToolBarCapture * False 

Case WM_M0USEM0VE 

' While tracking the mouse, draw the 
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button highlighting. The disadvantage is that you will 
need several bitmaps for each button to show it in all its 
states (up, down, disabled, etc.). Using a PicCIip control to 
hold all the button images uses up significantly fewer re¬ 
sources than threed. vbx controls, but this is still not opti¬ 
mal, since you still need a separate image control for each 
button. 


Listing 1 continued 


' button down if the mouse is over 
' button, otherwise draw the button up. 

If PtlnRect(ToolBarButtons(ButtonIndex)\ 
.rc. message.1Param) Then 
If Not bDepressed Then 
bDepressed = True 
Call ToolBarDrawButton(\ 
Buttonlndex. DownState) 

End If 
Else 

If bDepressed Then 
bDepressed = False 
Call ToolBarDrawButton(\ 
Buttonlndex. UpState) 

End If 
End If 

Case Else 
End Select 
End If 

Wend 

' Determine the new state of button 
If bDepressed Then 

ToolBarDepressButton = ToolBarButtons(Buttonlndex).ID 
If ToolBarButtonsfButtonlndexl.bAttributeButton Then 
If (UpState = ATTRIBUTEBUTTONJJP) Or (UpState =\ 
ATTRIBUTEBUTTONJ NDETERMINATE) Then 
NewState = ATTRIBUTEBUTTON_DOWN 
Else 

NewState = ATTRIBUTEBUTTON UP 
End If 
Else 

NewState = COMMANDBUTTONJJP 
End If 
Else 

ToolBarDepressButton = 0 
NewState * UpState 
End If 

' Set the new state of the button 

Call ToolBarSetButtonStatetButtonlndex, NewState) 

Else 

ToolBarDepressButton * 0 
End If 
End Function 

Sub ToolBarDrawButton (Buttonlndex As Integer, \ 
state As Integer) 

' Internal sub that calls UIToolButtonDraw to draw a 
' toolbar button 

' Parameters: 

' Buttonlndex - Index of toolbar button in button array 

' state - the state that the button will be drawn in 

Dim ec As Integer 

ec » UIToolButtonDraw%(Toolbar.hDC, ToolBarButtons\ 

(Button Index).rc.left, Tool BarButtons(ButtonIndex)\ 
.rc.top, ToolBarButtonWidth, ToolBarButtonHeight. \ 
hToolBarBitmap, ToolBarlmageWidth. \ 

Tool BarImageHeight. ToolBarButtons(ButtonIndex)\ 

.Index, state) 


Figure 2 Tracking the mouse with a modal 
message loop 


' Capture the mouse 
bToolBarCapture = True 
ec * SetCapture(Toolbar.hWnd) 

' Wait until the mouse button is released 
While (bToolBarCapture) 

If PeekMessagelmessage, Toolbar.hWnd, WM_MOUSEFIRST. \ 
WM_MOU$ELAST, PM_REM0VE) Then 
Select Case message.message 
Case WMLBUTTONUP 

' Check to see if mouse is still over button 
' and release the mouse capture 
bDepressed = PtInRect(ToolBarButtons( \ 

Buttonlndex).rc. message.IParam) 

Call ReleaseCapture 
bToolBarCapture = False 

Case WMJIOUSEMOVE 

' While tracking the mouse, draw the button \ 

' down if the mouse is over button. \ 

' otherwise draw the button up. 

If PtInRect(ToolBarButtons(ButtonIndex).rc, \ 
message.IParam) Then 
If Not bDepressed Then 
bDepressed * True 

Call ToolBarDrawButtontButtonlndex. DownState) 
End If 
Else 

If bDepressed Then 
bDepressed = False 

Call ToolBarDrawButtontButtonlndex, UpState) 
End If 
End If 
Case Else 
End Select 
End If 
Wend 
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Listing 1 continued 


End Sub 

End Sub 

Function ToolBarGetButtonState (ButtonID As Integer) \ 

Sub Tool BarInitButton (ButtonID As Integer, x As Integer, \ 

As Integer 

Bitmaplndex As Integer, bAttrButton As Integer) 

' Returns the current state of a toolbar button 

' Initializes a single toolbar button. Call this routine in 


' form load event of the form that contains the toolbar. 

' Parameters: 

' Toolbarlnit must be called before calling this sub. 

' ButtonID - ID of the toolbar button 


' return value - the state of the toolbar button 

' Parameters: 

Dim Buttonlndex As Integer 

ButtonID - ID of the toolbar button. This ID is 

returned by ToolBarDepressButton when the 

For Buttonlndex * 1 To ToolBarNumButtons 

button is pressed. Value must be non-zero. 

If ToolBarButtons(Buttonlndex).ID = ButtonID Then 

Zero is reserved to indicate that no 

Exit For 

button was pressed. 

End If 

' x - x coordinate of the button, in pixels. 

Next Buttonlndex 

ToolBarGetButtonState = ToolBarButtonst Buttonlndex).state 

relative to the toolbar control 

Bitmaplndex - Index into Buttonlmages (see Toolbarlnit) 

End Function 

for this button's image 

Sub Tool Bar Init (ToolbarControl As PictureBox, Buttonlmages \ 

bAttrButton - Set to True if this is an attribute button. 

As Image. ImageWidth As Integer, ImageHeight As Integer.! 


NumButtons As Integer. ButtonWidth As Integer. \ 

ToolBar8uttonIndex « Tool BarButtonlndex + 1 

ButtonHeight As Integer) 

If Tool BarButtonlndex > ToolBarNumButtons Then 

' Initializes the toolbar. 

Exit Sub 

' Call this routine in form load event of the form that 

End If 

' contains the toolbar 

' Initialize button data 

' Parameters: 

ToolBarButtons(ToolBarButtonlndex).ID = ButtonID 

ToolBarButtonsCToolBarButtonlndex).Index = Bitmaplndex 

ToolbarControl - PictureBox control that is the toolbar 

ToolBarButtons(ToolBarButtonlndex).bAttributeButton \ 

' Buttonlmages - Image control that holds the bitmap 

= bAttrButton 

images of the toolbar buttons 
' ImageWidth - Width of each image in Buttonlmages. 

' Set initial state of button 

All images must be the same width. 

If bAttrButton Then 

' ImageHei ght - Height of each image in Buttonlmages. 

ToolBarButtons(ToolBarButtonlndex).state \ 

* ATTRIBUTEBUTTON UP 

All images must be the same Height. 

Else 

' NumButtons - Number of toolbar buttons that will be 

Tool8arButtons(ToolBarButtonlndex).state \ 

displayed in the toolbar 

= COMMANDBUTTONJJP 

' ButtonWidth - Width of each button. All buttons must 

End If 

be the same width. 

' Save button location relative to toolbar 

ButtonHeight - Height of each button. All buttons must 

ToolBarButtons(ToolBa rButtonlndex).rc. 1 eft = x 

be the same Height. 

ToolBarButtons(ToolBarButtonlndex).rc.top « \ 

Dim OldScaleMode As Integer 

T00LBARJ0RDER + 1 

ToolBarButtons(ToolBarButtonlndex).rc.right = \ 

' Initialize Tool Bar data 

x + ToolBarButtonWidth 

ToolBarButtons(ToolBarButtonIndex).rc.bottom = \ 

ReDim ToolBarButtonsd To NumButtons) 

TOOLBAR BORDER + 1 + Tool BarButtonHei ght 

Set Toolbar = ToolbarControl 

End Sub 

hToolBarBitmap = Buttonlmages.Picture 

ToolBarlmageWidth * ImageWidth 

Sub ToolBarPaint 0 

ToolBarlmageHeight » ImageHeight 

' Paints all the toolbar buttons and also adds 3-D affect 

ToolBarNumButtons = NumButtons 

' to toolbar Call this routine from the toolbar paint event. 

ToolBarButtonWidth = ButtonWidth 

ToolBarButtonHeight * ButtonHeight 


ToolBarButtonlndex « 0 

' Initialize the Toolbar control 

' Give the toolbar a 3-D raised look (assumes toolbar 
' .scalemode * 3 (pixels)) 

Toolbar.Align « 1 Align top 

Toolbar.Line (0. 0)-(Toolbar.SealeWidth. 0). \ 

Toolbar.AutoRedraw * False ' Draw directly to window 

RGB(255. 255, 255) 

Toolbar.BackColor = RGBC192, 192, 192) ' Light gray 

Toolbar.Line (0. Toolbar.SealeHeight - 2)-\ 

Toolbar.BorderStyle = 0 'No border 

(Toolbar.ScaleWidth. Toolbar.SealeHeight - 2). \ 

RGB(128. 128, 128) 

Tool bar.Seal eMode * 3 Pixels 

Toolbar.Line (0, Toolbar.SealeHeight - l)-\ 

' Set height of Toolbar based upon height of buttons. 

(Toolbar.ScaleWidth, Toolbar.SealeHeight - 1), \ 

RGB(0. 0. 0) 

' Since our dimensions are in pixels, we need to 
' temporarly set the scalemode of the toolbar's parent 

' Draw all the buttons 

' form to pixels. 

01dScal eMode = Toolbar.Parent.SealeMode 

For i = 1 To ToolBarNumButtons 

Call ToolBarDrawButtonfi, ToolBarButtons(i).state) 

Toolbar.Parent.ScaleMode = 3 

Next i 

Toolbar.Height * ButtonHeight + TOOLBAR BORDER *2 + 3 

End Sub 

Toolbar.Parent.ScaleMode = 01dScaleMode 
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The best solution would involve using no controls at all 
for the buttons, just BitBltO'mg the buttons on the tool¬ 
bar. In fact, this is the technique used by several major 
applications. Fortunately, Microsoft provides a DLL called 
bttncur.dll that can draw toolbar buttons in all of the nec¬ 
essary states, (bttncur.dll is available free of charge and 
with no royalties - it even comes with source code. See 
the end of this article for a list of places to find 
bttncur.dll.) 

The bttncur.dll routine that I want to use is UIToolBut- 
tonDrawO. UIToolButtonDrawO will take a button image (just 
the face of the button, no borders), center it in the button, 
and then draw the button in the desired state. One bitmap 
image can generate all states: up, down, mouse down, dis¬ 
abled, down disabled, and indeterminate. The button is 
drawn on a specified device context at a given location, 
so this function is useful on standard owner-draw buttons 
as well as on toolbar controls. The buttons and image bit¬ 
map can be of any size. 

Another benefit of UIToolButtonDrawO is that it can draw 
all the toolbar buttons from a single bitmap. You just cre¬ 
ate a long, horizontal bitmap that contains all the button 
images side by side. You then need only a single image 
control to hold all the images for the entire toolbar, which 
means your use of system resources will be minimal. 

UIToolButtonDrawO only draws the buttons; you still 
have to write some code to check when the buttons have 
been pressed and to manage the state of the buttons. 


Figure 3 Initialization code for sample application 


' Initialize the toolbar 

Call ToolBarlnitCToolbar. ToolbarBitmaps, \ 

TOOLBUTTONJTDIMAGEWIDTH, TOOLBUTTON_STDIMAGEHEIGHT,\ 
NUM_T00LBAR_BUTT0NS, TOOLBUTTONJTDWIDTH, \ 

TOO LBUTTON_STDH ElGHT) 


' Now setup the toolbar buttons 
x = TOOLBUTTONJTDSEPERATOR * 2 
Call ToolBarInitButton(BUTT0N_FILENEW, x. \ 
T00LIMAGE_FILENEW. False) 
x = x + TOOLBUTTONJTDWIDTH - 1 
Call ToolBarlnitButtonCBUTT0N_FILEOPEN, x, \ 
T00LIMAGE_FILEOPEN, False) 
x = x + T00LBUTT0N_STDWIDTH - 1 
Call ToolBarlnitButtonCBUTTON_FILESAVE, x. \ 
T00LIMAGE_FILESAVE. False) 

x = x + T00LBUTT0N_STDWIDTH + TOOLBUTTONJTDSEPERATOR 
Call ToolBarlnitButtonCBUTTON_EDITCUT, x, \ 
TOOLIMAGEJDITCUT, False) 
x = x + TOOLBUTTONJTDWIDTH - 1 
Call ToolBarlnitButton(BUTTON_EDITCOPY, x, \ 
TOOLIMAGEJDITCOPY, False) 
x = x + TOOLBUTTONJTDWIDTH - 1 
Call Tool Barlni tButton(BUTTON JDITPASTE, x, \ 
TOOLIMAGEJDITPASTE, False) 

x = x + TOOLBUTTONJTDWIDTH + TOOLBUTTONJTDSEPERATOR 
Call ToolBarlnitButtonCBUTT0N_FILEPRINT, x, \ 
TOOLIMAGEJILEPRINT. False) 

x = x + TOOLBUTTONJTDWIDTH + TOOLBUTTONJTDSEPERATOR 
Call ToolBarlnitButtonCBUTTON_HELPCONTEXT. x, \ 
TOOLIMAGEJELPCONTEXT, True) 


New VxD Toolkit Enables Rapid 
Windows Device Driver Development 


This is a real, I ^ r ° n1: J ac kJP@) o n « 

.. . ' Date; Wed oa,. 0rn 

- Ur-*-— 

I ^ThanT, co Ve,OPer for 


Call for data sheets, examples, 
reviews and pricing. 


VtoolsD 


Vireo Software — The VxD Tools Company 

385 Long Hill Road, Bolton, MA 01740 
Call: 508-779-8352 Fax: 508-779-8351 
Vireo@vireo.com http://world.std.com/'vireo/ 

VtoolsD is a trademark of Vireo Software. Inc. Microsoft is a registered trademark and Windows is a trademark of Microsoft Corporation 



□ Request Reader Service #101 O 


C and C++ DOCUMENTATION 


C-METRIC™ ($59) - Complexity/Quality 

• Calculates "cyclomatic’ path complexity for functions and system 

• Counts lines with comments, code, and ‘C statements 

C-CALL™ ($69) - Function Hierarchy 

• Tree-Diagram showing function hierarchy 

• Table-of-Contents of functions versus files 

• Summary and detailed cross-reference of functions 


filel main 

file2 

— sub2 

file2 

1— sub3 

file2 

1—sub4 

filel 

— main(recursv) 


— Ibryl, Ibry2 


C-CMT™ ($69) - Function Comment 

• Generates and inserts function comment blocks 

• Can be re-run to update the comment blocks 



/*FF.*. 

sub2 USERS: main 

CALLS: sub3 sub4 
PARAM: argl arg2 
LOCAL: varl 
GLOBL: var2 var3 
..•**•—•***/ 


C-LIST™ ($69) - Lists or Reformats 

• Action-Diagrams show logic/control flow 

• Reformats source to various standardized formats 


C-REF™ ($69) - Cross-References Identifiers 

• Local/global/define/parameter summary or cross-reference 

• Produces class-hierarchy tree-diagram for C++ classes 

C-BROWSE™ ($free in C-DOC) - Windows Tree Viewer 

• Graphically view C-CALL function-trees or C-REF class-trees 

C-DOC™ ($199) - DOS/Windows Package ($395 value) 

• All 5 programs integrated as 1 overall C-DOC program 

• Processes multiple directories/files up to 10,000 lines 

• Unconditional 30-day money-back guarantee of satisfaction 

C-DOC™ Professional ($299) - DOS, Windows, OS/2 

•All features of C-DOC, processes 1,000,000 lines, 3-ring binder/case 


!! NEW 6.0!! Windows Graphic-Tree Viewer 


SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way ■■■ 

Mississauga 0NT Voice/Fax (905)858-4466 
Canada L5N-4M1 Demo/BBS (905) 858-1916 CALL NOW! 


August 1995 


□ Request Reader Service #118 □ 

Windows/DOS Developer’s Journal — Page 57 





































Learn how DOS works 
under-the-covers 


Vv 

v * 

*& 


w 


MS-DOS 

system programming 


29 Pearls for DOS Programmers 


edited by 

David Burki 
Robert Ward 


MS-DOS System Programming 

Third edition 

edited by 

David Burki & Robert Ward 

David Burki is a programmer/analyst employed 
by PDA, Inc., working with MS-DOS, Windows, 
and OS/2. His most recent development projects 
have been an e-mail system with a GUI interface 
for a local network of PCs running OS/2, and a 
database processor for targeted marketing using 
demographic profiles. 

Robert Ward is a well-known technical author 
and lecturer. He wrote the book Debugging C, 
and founded R&D Publications, Inc. 


Beginners and veterans will 
find something in this 
collection to save time and 
provide more efficient 
MS-DOS systems 
programming. 

This trove of 29 tricks 
has something for every 
DOS programmer 

The third edition, updated for DOS 5 and 6. For 
sophisticated developers, who want detailed 
explanations of undocumented system calls and 
hardware interfaces. Revised chapters explain 
event timing, accessing the global environment, 
TSRs, critical error handling, modifying the DOS 
boot, interrupt-driven serial I/O, interfacing to the 
floppy disk controller, and writing device drivers. 

New chapters cover programming serial 
communications, the floating point coprocessor, 
the PC speaker, CD-ROM drivers, Direct Memory 
Access, VGA graphics animation, self-loading 
device drivers, handling DOS file handle limits, 
and the Loadall instruction. Each chapter gives 
complete details and can be read independently. 


Technical 
Books 

Satisfaction 
Guaranteed . 


Use code V36 to order 

MS-DOS, third edition 

913-841-1631 
FAX 913-841 -2624 


VISA 


□ Request Reader Service #164 □ 





























Listing 1 continued 

Sub ToolBarSetButtonState (ButtonlD As Integer, \ 

For i = 1 To ToolBarNumButtons 

state As Integer) 

If ToolBarButtonsCi).ID = ButtonlD Then 

' Sets the current state of a toolbar button 

Buttonlndex = i 


Exit For 


End If 

' Parameters: 

Next i 

ButtonlD - ID of the toolbar button 


' state - the new state of the toolbar button 

If Buttonlndex > 0 Then 


Tool BarButtonsf Button Index).state = state 

Dim Buttonlndex As Integer 

Call ToolBarDrawButtonIButtonIndex, state) 

Dim i As Integer 

End If 


End Sub 

Buttonlndex = 9 

/* End of File */ 


The Mouse Interface 

As discussed earlier, after the user 
clicks on a toolbar button, you need 
to be able to determine when the 
mouse cursor leaves and enters a 
button while the mouse button is 
down. This applies even if the user 
moves the cursor moves out of the 
toolbar window itself. Therefore 1 in¬ 
voke SetCaptureO when the user 
clicks on the button. Calling SetCap¬ 
tureO forces all mouse input to come 
to the specified window (instead of 
whatever window the mouse is over) 
until ReleaseCaptureO is called. Once 
the mouse is captured, I use Ptln- 
RectO to determine if the mouse is 
over a button. 

I chose to use a modal message 
loop to check for mouse messages. 
This approach has the benefit of 
placing all the code for tracking the 
mouse in a single procedure, rather 
than spreading it across the mouse 
move and button up events. The 
code shown in Figure 2 implements 
the modal message loop that tracks 
the mouse. Notice that the PeekMes- 
sageO call only checks for mouse 
messages; all other message will re¬ 
main in the message queue until the 
button is released. When the code 
finds a mouse move event, it checks 
the current cursor location so that it 
can draw the button correctly as the 
cursor leaves and re-enters the but¬ 
ton. On button up, the code checks if 
the cursor is still over the button and 
then releases the mouse capture and 
finally falls out of the loop. After the 
mouse is released, I need to redraw 
the button in its new state, or in its 
previous state if the button was not 
pressed. For an attribute button, the 


□ Request Fax #1082 □ 

Windows/DOS Developer’s Journal — Page 59 


//// 
*' 


for C/C++ 

presents Bug # 564 



The programmer is attempting to initialize an array so that element i has the 
value i. But, there is a subtle machine dependency. Can you spot it? Call if you 
need a hint. Refer to Bug #564. 


PC-lint for C/C++ will catch this and many 
other bugs. It will analyze a mixed suite of C 
and C++ modules to uncover bugs, glitches, 
quirks and inconsistencies. 

Numerous C++Warnings and Messages: 
Are your inherited destructors virtual? Are 
your constructor new’s matched by your 
destructor delete’s? Are your initializers 
in order? Are names inadvertently hiding 
other names? Are your C++ modules 
consistent with your C modules? Much, 
much, more. 

Plus Our Traditional C Warnings: 

Uninitialized variables, unaccessed variables, 
possibly uninitialized variables, strong type 
mismatches, indentation irregularities, loss of 
precision, strange uses of Booleans, 
signed/unsigned mismatches, suspicious 
expressions, unused macros, etc. etc. 


Full C++ Support - PC-lint for C/C++ 
is based on the ARM and is tracking the 
latest ANSI/ISO draft including exceptions 
and templates. It supports both Borland and 
Microsoft C/C++. 

PC-lint for C/C++ $239 

Numerous compilers/ libraries supported. 
Runs on MS-DOS (Optional built-in 386 
DOS extender), OS/2, NT and Windows 95. 
PC-lint for C is still available for only $139. 

FlexeLint for C/C+ + 

The same great product for other operating 
systems. Runs on all Unix systems, VMS, 
mainframes, etc. Distributed in shrouded 
C source form. Call for pricing. 


PA add 6% sales tax, 


©tap®! S©ftwnr<s 

3207 Hogarth Lane, Collegeville, PA 19426 

CALL TODAY (610) 584-4261 Or FAX (610) 584-4266 

30 Day Money-back Guarantee. 

PC-lint and FlexeLint are trademarks of Gimpel Software 


August 1995 












Figure 4 Responding to ToolBarDepressButtonQ 


Select Case ToolBarDepressButtonO 
Case BUTT0N_F1LENEW 

MsgBox "File New Button Pressed" 

Case BUTT0N_FILEOPEN 

MsgBox "File Open Button Pressed" 

Case BUTT0N_FILESAVE 

MsgBox "File Save Button Pressed" 

Case BUTTONJDITCUT 

Call ToolBarSetButtonState(BUTTON_EDITPASTE, \ 
COMMANDBUTTONJP) 

MsgBox "Edit Cut Button Pressed" 

Case BUTTON_EDITCOPY 

Call ToolBarSetButtonState(BUTTON_EDITPASTE, \ 
COMMANDBUTTONJP) 

MsgBox "Edit Copy Button Pressed" 

Case BUTTON_EDITPASTE 

MsgBox "Edit Paste Button Pressed" 

Case BUTT0N_FILEPRINT 

MsgBox "File Print Button Pressed" 

Case BUTTONJELPCONTEXT 

If Tool BarGetButtonStatet BUTTONJELPCONTEXT) = \ 
ATTRIBUTEBUTTONJP Then 
MsgBox "Help Context is Off" 

End If 

If ToolBarGetButtonStatelBUTTONJELPCONTEXT) = \ 
ATTRIBUTEBUTTON_DOWN Then 
MsgBox "Help Context is On" 

End If 
End Select 
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-Q < windows h> 
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new state is toggled between up and down. For a com¬ 
mand button the new state is always up. 

Putting It All Together 

tool bar. bas (Listing 1) provides a complete package to 
implement a toolbar using the techniques discussed 
above. In the magazine listing, long lines broken in two 
are indicated with a backslash (*V). The code disk contains 
the original, compilable source. Adding a toolbar to your 
form is a matter of just a few simple steps. 

First, create a toolbar for the form by adding a Picture- 
Box control with the Align property set to "Align Top'. 
Next, add an Image control to the form to hold the bit¬ 
map that contains your toolbar images. Remember to 
make this control invisible by setting the Visible property 
to "False", bttncur.dll comes with a bitmap that contains 
all the images for common toolbar buttons. This bitmap is 
a good starting point for your own toolbar. 

The next step is to add the code to initialize your tool¬ 
bar. This step has two parts: first, call ToolbarlnitO to in¬ 
itialize the toolbar, then call ToolbarButtonlnitO to initialize 
each button. The initialization code should be located in 
the load event of your form. Figure 3 shows the initializa¬ 
tion code for the sample application. When initializing 
each button, you assign an ID to that button. The ID will 
be returned when the button is pressed. See the com¬ 
ments in the routine headers for an explanation of each 
parameter. 

After the initialization code is complete, the next step is 
to add the code that actually draws the toolbar buttons. In 
the paint event for your toolbar control, add a call to 
ToolbarPaintO. ToolbarPaintO will paint all the toolbar but¬ 
tons and also add a 3-D effect to the toolbar itself. 

The last step is to add the code to check for button 
presses. In the mouse-down event of the toolbar, add a 
call to ToolbarDepressButtonO. ToolBarDepressButtonO will re¬ 
turn the ID of the pressed button, or zero, if no button 
was pressed. Figure 4 shows the code used by the sample 
application in response to ToolBarDepressButtonO. 

tool bar. bas (Listing 1) also provide routines to get and 
set the current state of a button. These routines are espe¬ 
cially useful for disabling and enabling buttons, but they 
can be used to set a button to any of the supported 
states. 

The sample application (on this issue's codedisk; see 
the table of contents for availability) shows how to create 
a toolbar using tool bar. bas and the image bitmap included 
with bttncur.dll. When a toolbar button is pressed, the 
sample application will display a message box indicating 
which button was pressed. 

Availability of bttncur.dll 

bttncur.dll can be found in several places, it is avail¬ 
able on CompuServe in the MS Windows SDK forum as 
btncrZ.zip. You can find it on Microsoft Developer Net¬ 
work CD by searching for "bttncur". It is also distributed 
with The Windows Interface, An Application Design Guide, 
published by Microsoft Press. □ 
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Parsing Windows’ sLongDate 

George Tylutki 


Windows contains some support for adapting to different locales. The end 
user can use Control Panel's International applet (see Figure 1) to set the cur¬ 
rent country and language, as well as various preferences about how to display 
dates, times, and so on. When the end user makes these changes, the Control 
Panel applet stores the new information as strings in the international section 
([Inti]} of win. ini. The individual entries in this section of win. ini are docu¬ 
mented in chapter 18 of the Microsoft Windows SDK Programmer's Reference, Vol¬ 
ume 1. Since even domestic users can and do makes changes to these settings 
(and expect changes made 'to Windows' to be reflected in every application), it 
is essential that developers make use of this information. 

Generally, this is easy to do since the settings are easy to read and interpret, 
except when it comes to dates. The [Inti] section of win. ini contains two dif¬ 
ferent entries for specifying how to format dates: sShortDate (specifies a short, 
numerical format for dates) and sLongDate (specifies dates that may include 
strings). There is a tendency among developers to use sShortDate (which pro¬ 
duces dates such as '1/16/96') to format dates rather than sLongDate (which 
produces more complex dates such as "January the 16, 1995'), because it is 
much easier to decipher. This article discusses the nuances of these date for¬ 
mats and how they differ under different versions of Windows; I also provide a 
parser that correctly handles the long date format. 

Understanding Date Formats 

Figure 2 shows the dialog box that the end user sees when using the Con¬ 
trol Panel to modify the format for dates. With the long date format, the user 
can control the formats of the month, day, and year fields, but can also specify 
arbitrary strings to appear between them. The Control Panel applet transforms 
the data the user enters in this dialog into a "picture" format and stores it as a 
string in the sShortDate and sLongDate entries of the [Inti] section of win.ini. I 
will focus on the more complicated sLongDate entry, which contains the format 
that you have to understand and parse in order to display long dates correctly 
for the current locale. 

Here is an example of the kind of string that might be stored in the sLong¬ 
Date entry (throughout this article, I use an underscore to denote spaces in 
format strings): 

s LongDate=dddd_MMMM_dd,_yyyy 

Some of the items (the commas and spaces) in this string are literal strings, 
which you should copy verbatim when formatting a long date. The other items 
in the string specify formats for parts of the date. For example, 'MMMM' means 
to display the full text of the name of the month (e.g., "September"), and "dd' 
means to display the day of the month as a two-digit number, padded on the 
left with a zero when necessary. Table 1 shows the complete list of format 
specifiers that can appear in the sLongDate entry of the [Inti] section of win. ini. 

The difficulties involved in parsing sLongDate include the following: 


George Tylutki holds a Ph.D. in English and is a partner in 100% Cotton Software (RR 
1, Box 1622, Hop Bottom, PA 18824), which publishes NFL Forecaster, Have You Read 
That Movie?, and other programs. 
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International 


International - Date Format 


Country: 
Language: 
Keyboard Layout: 
Measurement: 


■ 


English (American) 


US 


English 


0 



List Separator: -_| 


Date Format 

Currency Format 

4/27/95 | Change... j 

$1.22 


Change... j 


($1-22) 




Xime Format 


Number Format 

11:58:30 PM 

Change... \ 

1.234.22 

Change .. j 


Short Date Format 

Order: ®iMDYj Q DMY O YMD 

Separator: | / \ 

□ Day Leading Zero (07 vs. 7) 
l~l Month Leading Zero (02 vs. 2) 

CD Century (1990 vs. 90) 


OK 
Cancel ] 

Help | 


Long Date Format 

Order: ® MDY O DMY O YMD 


Sunday 

3 


March 

*1 


05 

±j 

, 

1995 


Sunday. March 05, 1995 


Figure 1 The International Control Panel applet 


Figure 2 The Change Date applet dialog 


• the day of the week (and its trailing separator) may be 
missing 

• the separator strings may or may not be enclosed in sin¬ 
gle quotes and may contain d's, m's, y"s and single quotes 

• single quotes within separators are doubled when writ¬ 
ten to disk by Windows 3.1 x but not by Windows 3.0 

• separators not enclosed in single quotes usually end in 
a space character, but may include an 'implied' space 

• Windows 3.0 allows users to enter very long separators 



VERSION CONTROL 


Distributed Revision 
Tracking System 


Parallel Development 
DRTS is based on a powerful software develop¬ 
ment model which allows Individuals and teams to 
work in parallel. Developers concentrate on developing 
software while DRTS tracks every change. Integrating 
multiple sets of changes is efficient and easy. 


o Order, Call: 1-602-991-8281 

isa/MC Accepted 

'OS $300 WINDOWS $300 

>S/2 $300 UNIX $500 

iuantity Discounts Available 


ISI 

6325 East Monte Cristo 
Scottsdale, AZ 85254 


Controlled Development 

DRTS is a flexible system which 
adapts to your development 
process. As you develop, 
integrate, test, and 
release, DRTS tracks every 
change at every stage. 
Maintaining multiple 
concurrent releases is 
possible because DRTS 
allows you to easily 
propagate changes 
from one release 
the next. 


DRTS provides seamless 
integration across 
diverse computing 
environments 
including servers, 
workstations, and 
laptop computers 
running Windows, 
DOS, OS/2 and 
UNIX. Whether your 
development occurs 
on a LAN or between 
multiple sites, DRTS tracks 
changes where they 
are made. 


Taking these problems as a whole, the key to parsing 
sLongDate lies in determining the beginnings and ends of 
the separators. When this is taken care of, everything else 
(except the Windows 3.0 problems) falls into place. 

The Control Panel applet usually writes sLongDate with¬ 
out using single quotes to delimit the literal strings that 
separate the fields of the date. For example, if a user 
chooses Ireland's default long date format ('12_Janu- 
ary_1995'), win. ini will contain 

sLongDate=dd_mmmm _yy 

However, Taiwan's format ("12_of January,_1995") is stored as 
s LongDate=dd ’_of_’ mmnim ,yyyy 

The first separator ("_of_") is enclosed in single quotes, but 
the second (a comma between 'mmmm" and 'yyyy") is 


Table 1 Format specifiers for sLongDate 

Value 

Category 

Format 

d 

date 

1, 2, etc. 

dd 

date 

01, 02, etc. 

ddd 

day of week 

Mon, Tue, etc. 

dddd 

day of week 

Monday, Tuesday, etc. 

m 

month 

1, 2, etc. 

mm 

month 

01, 02, etc. 

mmm 

month 

Jan, Feb, etc. 

mmmm 

month 

January, February, etc. 

yy 

year 

94, 95, etc. 

yyyy 

year 

1994, 1995, etc. 
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not. Further, there is no space after 
the comma; it is implied. If you use 
the Control Panel applet to first set 
the country code to Taiwan, and 
then press the button to change the 
date format, the date is displayed 
near the bottom of the dialog with 
the space after the comma. And 
South Korea's ("sLong- 

Date=yyy.mm.dd") is displayed as 
"1995._12._ir. Every sLongDate sepa¬ 
rator is or contains an actual or im¬ 
plied space (see Table 2). 

The code disk (see table of con¬ 
tents for availability) contains a dem¬ 
onstration program (see Figure 3) 
that displays both the sLongDate entry 
from win.ini, and a date formatted 
with that specification. You can verify 
that these spaces are implied by run¬ 
ning the demonstration program and 
then Control Panel's International ap¬ 
plet. Choose a country from the list- 
box, press the Date Format Change button and immedi¬ 
ately press the OK button (thus making no changes and 
accepting the defaults). The caption of the demonstration 


12:00 AM Friday, April 28. 1995 [dddd, MMMM dd. yyyy) 


Figure 3 The date parsing demonstration program 


Table 2 Example output from sLongDate specifications 

Country 

sLongDate value 

As displayed by Control 
Panel applet 

Australia 

dddd,d mmmm yyyy 

dddd','d''mmmm''yyyy 

Brazil 

dddd,d'de'mmmm'dejyyyy 

dddd','d'de'rnmmm'de'yyyy 

Denmark 

d.mmmm yyyy 

'Jd'.Jmmmm'Jyyyy 

Ireland 

dd mmmm yyyy 

''dd''mmmm''yyyy 

South Korea 

yyyy.mm.dd 

'-'yyyy'-'mm'.jdd 

Sweden 

'den'd mmmm yyyy 

'den'd''mmmm''yyyy 

Taiwan 

dd'_of_'mmmm,yyyy 

'_'dd'_of_'mmmm',_'yyyy 


program's main window will display sLongDate as it ap¬ 
pears in win. ini. For Taiwan you will see 


sLongDate=’_’dd’_of_’mmmnr ,_’yyy 


(continued on page 66) 


Listing 1 Iddemo.pas — Source to date parsing 
program 


{ sLongDate Parser Demo by George Tylutki, Borland Pascal 7.0 } 

PROGRAM LDDemo; 

USES WinTypes, WinProcs, OWindows, WinDos, Strings; 

CONST 

MaxSepLen = 6; 
type 

tChar9 = array[0..9] of char; 
tChar8 = array[0..8] of char; 
tChar6 = array[0..MaxSepLen] of char; 
tChar4 = array[0..4] of char; 

CONST 

LongDayNameArray : array[0..6] of tChar9 = (’Sunday’, ’Monday’, 

’Tuesday’, 'Wednesday’.’Thursday’, ’Friday’. ’Saturday’); 
LongMonthNameArray : array[1..12] of tChar9 = (’January’, ’February’, 
’March', 'April’, ’May’, ’June’, ’July', ’August’, ’September’, 
’October’, ’November’, ’December’); 

FormatStr : array[1..2] of tChar4 = (’%d’. ’X02d'); 

TYPE 

tLongDateTimeRec = record 

TimeSep : array[0..1] of char; {ex. :} 

Time24Hour : boolean; {true= 24-hour; false= 12-hour} 

TimeTrailers : array[false..true] of tChar8; {ex. pm & am} 

HoursLeadingZero : integer; {1=1; 2=01} 

DateSeps : array[1..3] of tChar6; {ex. ’.’ & ’ ’ between mon, day, yr} 
DaylChar : integer; {l=d=l; 2=dd=01} 

Year2Char : boolean; {true=yy=94; false=yyyy=1994} 

Day0fWeek3Char : integer; {-l=none; 0=ddd=Sun; l=dddd=Sunday} 

MonthFormat : integer; {l(m)=3; 2(mm)=03; 3(mmm)=Mar; 4(mmmm)=March} 
DateOrder : integer; {1=MDY; 2=DMY; 3=YMD} 

end; 

pLongDateMainWin = A tLongDateMainWin; 
tLongDateMainWin = object(tWindow) 

LongDateTimeRec : tLongDateTimeRec; 
procedure SetupWindow; virtual; 
procedure ReadWinlni; 

procedure ParseLongDate(LongDateStr : pChar); 



Add LIFE to your applications with 



Demo / Tutorial / CBT / Presentation 


Development Kit 


• Live interactive demo • Traditional slide-show demo 

• Live interactive tutorial • AVI/BMP - captured demo 

• CBT with live control • Integration, automation 

• Live multimedia presentation • Macro-extension, installation 


% 


Using ShowBasic engine you can control your (or any other) 
application visually by emulating mouse and keyboard. Select 
from menus, click on dialog box controls, enter text, drag and 
drop, draw - you can code and visually play all this from your 
ShowBasic program. ShowBasic Recorder will generate the 


source code for you while you use your mouse and keyboard. 


<% 

% 




Use pop-up windows with text and graphics, create dialog 
boxes, add transition effects, sprite animation, decorations and 
highlighting, multimedia sound and video (WAV, MIDI and 
AVI). Need real CBT? Track and handle events: mouse and 
keyboard actions, windows activation, focus change and even 
raw Windows™ messages. Concerned with space? Pack all 
your code with supporting files in compressed compound 
module. You will discover many more nice features... 


Yes, you will be using full featured Basic to write your code. 

Yes. you can access Windows™ API and call functions in other DLLs. 
Yes, you can control ShowBasic from WinHelp, VB and other apps. 
ShowBasic demo available on CompuServe (sbdemo.zip WINSDK Lib 4) 
and on Internet (ftp.cica.indiana.edu /pub/pc/win.3/demo/sbdemo.zip) 
Development license $299. 30 day money back guarantee. 
Royalty free licenses available. Visa/MC accepted. 

For a limited time', get FREE StDemo Player 1 .5 royalty free site 
license ($300 value) with your ShowBasic distribution license purchase. 
(Please mention offer #1979). 

MIKSoft, Inc. tel/fax: 908-390-8986 

37 Landsdowne Road. East Brunswick NJ. 08816 
Internet: mik@cnj.digex.com CompuServe: 74127,3671 
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and for South Korea 
sLongDate=’_'yyy' ._’dd 

Not only is a space appended to the two separators between 
the year, month, and date, but a space is inserted at the 
beginning of sLongDate. That is, ail three separators should 


end in a space, and if any of the three is missing, there is 
still an implied space. Since users will expect applications 
to display the date as Windows does in the International 
applet, these implied spaces must be taken into account. 

The default separators usually consist of commas, peri¬ 
ods, and spaces. Spanish-language countries' separators 
contain '_de_' (remember, I am using to denote 


Listing 1 continued 


procedure ShowDateAndTime; 

procedure wmW1nIniChange(var Msg: tMessage); virtual 
wm_First + wm_WinIniChange; 
procedure wmTimeChange(var Msg: tMessage): virtual 
wm_F1r$t + wm_TimeChange; 
end; 

tLongDateApp = object(tApplication) 
procedure InitMainWindow: virtual; 
end; 

VAR 

sLongDateStr : array[0..54] of char; {used only to display sLongDate} 

{========================================} 

procedure tLongDateMainWin.SetupWindow; 
begin 

inherited SetupWindow; 

MoveW1ndow(hW1ndow, 10, 10, 620, 6etSystemMetrics(sm_cyCaption), true); 
ReadWinlni; 

ShowDateAndTime; 

end; 


procedure tLongDateMainWin.ReadWinlni; 
const 


.PC-Install 

VERSION 3 



PC-Install is an easy to use 
installation program for DOS 
and Windows™ developers who 
distribute applications or data 
files to end users. With this 
award winning product, you can 
create a professional installation 
in less than 30 minutes. 



We offer a 30-day money-back 
guarantee and unlimited, free 
technical support. 


Call 800-735-2020 

for more information. 


PC-Install for DOS.$99 

PC-Install for DOS w/PC-Shrink.$149 

PC-Install for Windows w/PC-Shrink .... $179 
PC-Install Combo 

(DOS. Windows & PC-Shrink) .$249 




Display custom graphics, titles and messages. 
Install user selectable file sets. 

Install to multiple destination directories. 
Request any type of user input. 

Test for video, memory, CPU, and/or disk space. 
Test for .DLL and .VBX file versions. 
Conditional installation execution. 

Modify Autoexec, Config, .INI, or any text files. 
File search and control. 

Create or modify Windows groups and icons. 
Install from different directories. 

Multiple application execution. 

Custom messages and prompts including 
non-English installations. 

Enhanced PC-Shrink™ file compressor. 
Royalty-free distribution license. 


Paradox 

K 


03 

MCTOSOFT. 

windows,. 

COMESTIBLE 


20/20 Software, Inc. 

8196 SW Hall Blvd., Suite 200 
Beaverton, OR 97008 
503-520-0504 • 503-520-9118 FAX 


CompuServe": 74774,222 or GO TWENTY 
Internet: info@twenty.com or http://www.twenty.com/-twenty 


2 % 

SOFTWARE 


defaultLongDateStr : array[0..23] of char = 

’dddd” ''imnnm’’ ”d”, ”yyyy’; 
begin 

with LongDateTimeRec do 
begin 

GetProfileStrlngf'inti', 'sTime', *:*, TimeSep, sizeof(TimeSep)); 
Time24Hour := boolean(GetProfi1elnt('Inti*. ’iTime’, 0)); 

GetProfileString('inti’, ’s2359’. ’pm’, 

TimeTrailersCfalse], sizeof(TimeTrailers[false])); 

GetProfileString('inti*. ’sll59’, ’am’, 

TimeTrailers[true], sizeof(TimeTrailers[true])); 
HoursLeadingZero := GetProf11elnt(*1ntl*, 'iTLZero’, 0) + 1; 
if GetProfileString(’inti’. ’sLongDate’, defaultLongDateStr, 
sLongDateStr, sizeof(sLongDateStr)) > 53 then 
StrCopy(sLongDateStr, defaultLongDateStr); 
end; 

ParseLongDate(sLongDateStr); 
end; 


procedure tLongDateMainWin.ParseLongDate(LongDateStr : pChar); 
const 

TheCowsComeHome : boolean = false; 

HellFreezesOver : boolean = false; 
var 

SepNum, 

First, Index, x : integer; 

ParsingSep, 

QuotedSep : boolean; 
begin 

with LongDateTimeRec do 
begin 


{separator 1. 2, or 3} 

{rather than of mon, day. or yr picture) 
{ex. ’, ’ or ’ of ’} 


{set some defaults in case LongDateStr is bad) 
for SepNum := 1 to 3 do StrCopy(DateSeps[SepNuni], ’ ’); 

DateOrder := 0; {set/checked below) 
Day0fWeek3Char := -1; {no day of week) 
DaylChar := 1; {1. 2. etc.) 
Year2Char := false; {1995, 1996, etc.) 


ParsingSep := false; 

Index := 0; 

if LongDateStr[Index] = ”” then 
begin 

ParsingSep := true; 

QuotedSep := true; 

Index := 1; 
end; 


First := 0; 

SepNum := 1; 
repeat 

if ParsingSep then 
begin 
x := 0; 
repeat 

if x < MaxSepLen then DateSeps[SepNum][x] := 

LongDateStrCIndex]; {accept no more than 6 chars) 

if QuotedSep 

and (LongDateStrCIndex] = ’”') {quote in separator) 

and (LongDateStrCIndex + 1] = ””) then 
1nc(Index); {accept 1 ’; skip one ’} 

1nc(Index); 

1nc(x); 

if (LongDateStrCIndex] = #0) {not expected; bad string) 

or (QuotedSep {end of quoted separator?) 

and (LongDateStrCIndex] = "”) 

and (LongDateStrCIndex - 1] <> ””) {a space) 

and (LongDateStrCIndex + 1] <> ”")) {d, m. y) 

or (not QuotedSep {end of unquoted separator?) 

and (LongDateStrCIndex] in 
C’d’.’D’.’m’.'M’.’y'.'Y'])) then break; 
until TheCowsComeHome; 
if x > MaxSepLen then x := MaxSepLen; 

DateSeps[SepNum][x] := #0; 

ParsingSep := false; 
end 

else {parsing day of week, day, month, year picture) 

begin 
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spaces), Sweden's includes '_den_', and Finland's appends 
'ta_' to the end of the month separator. Via the Date For¬ 
mat Change button, users can enter up to five characters 
(d's, m's, y's and single quotes are legal too) into a separa¬ 
tor (a space is appended to the end) under Windows 3.1 x 
and many characters under Windows 3.0. Five single 


quotes entered into the separator between the date and 
month of Ireland's long date format will yield 

sLongDate=’_’dd.. " _’mmmm’_’yyyy 

under Win 3.1 x, but 


(continued on page 69) 


Listing 1 continued 

repeat 


’Y' : 


inc(Index); 


begin 


until ( LongDateStrCIndex] = #0) 

{expected} 

Year2Char := (x = 2); {true=94; 

false =1994} 

or ( LongDateStr[Index] <> LongDateStr[First]); 


if DateOrder = 0 then DateOrder := 3; 

(ymd) 

x := Index - First; 

{length} 

end; 


case UpCasef LongDateStr[First] ) of 


end; 


’D’ : 


inc(SepNum); 


begin 


if SepNum > 3 then SepNum := 3; 


case x of 


ParsingSep := true; 


1. 2 : 


if LongDateStr[Index] = "’’ then QuotedSep := true 


begin 


else QuotedSep := false; 


DaylChar := x; 

{1=1-31; 2=01-31} 

end; 


if DateOrder = 0 then DateOrder := 2; 

Idmy} 

if LongDateStr[Index] = #0 then break 


end; 


else 


3, 4 : 


begin 


begin 


if LongDateStrC Index] = ”” then i nc( Index) ; 

{skip ’) 

Day0fWeek3Char := ord(x = 4); {false=0=Sun; true=l=Sunday) 

First ;= Index; 


SepNum := 0; {so it will increment to 1; we just} 

end; 


end; {parsed day of week, so 1st separator next} 

until Hel 1 FreezesOver ; 


end; 




end; 


for Index := 1 to 3 do 


’M* : 


begin {be sure end of separator is ’ '} 

begin 


x := StrLen(DateSeps[Index]); 


MonthFormat := x; {1=1-12; 2=01-12; 

3=Jan; 4=January} 

if DateSeps[Index][x - 1] <> ' ’ then 


if DateOrder = 0 then DateOrder := 1; 

tndy) 

begin 


end; 


if x < MaxSepLen then StrCat(DateSeps[Index], ' ’) 



more than Just a Database Browser 


Strings 

Integer 

Long 

Float 

Double 

-t- 

Field 1 

123 

35686 

23.9 

6736755,000 


Field 2 

5784 

35686 

345 786 

6736755,000 


Field 3 

32464 

35686 

78 86 

6736755,000 

— 

Field 4 

7637 

35686 

345 

6736755,000 

■— 






♦ 

*L 



LL 

| ♦ 



Edit[T]able 

The purpose of Edit[T]able is to provide a table structure on screen as an 
interface between an end user, browsing or typing in data, and the application 
managing the data. Edit[T]able DLL is database independent. 

The transfer between the end user and the DLL is supported by WINDOWS'", 
the transfer between the DLL and the application is done via classes and calls 
to their virtual functions, i.e. the functions are coded in the application, but 
called from the Edit[T]able DLL. 

In C applications, the virtual functions are replaced by function pointers. 


Supported field types: 

String IntegQt Long Float Double Date Time 

The layout and the attributes of the table structure and the fields are to be 
defined with a separate design tool(included), so that you can change these 
attributes without re-compiling the application. 

A free demo disk with examples for linked list, array structure and PARADOX® 
Engine is available. 

Soimsstr. 23 u o bR * +49 30 692 44 95 

10961 Berlin Fax +49 30 692 35 55 

Germany a*® 6 H CompuServe ID: 100325,1266 
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Do you need HLP from WP? 


Save weeks of time with 


Help Perfect 


Help Perfect turns your WordPerfect docs 
into great Windows Help files 


+ Create Help files with your favorite word processor: WP 
+ Keep on using your preferred styles and layouts 
+ As you write the manual, you’re also writing the Help file 
+ Convert existing WP files to WinHelp and MMViewer 
+ DLL for multimedia, 256/full color graphics and more... 

+ Automate the entire Windows Help authoring process 


for HELP WITHOUT HASSLE 
contact 


In North and South America: 

European Software Connection 

Tel (913) 832 2070 
Fax (913) 832 8787 
CIS 71141,3624 


Elsewhere: 
Niceware 

Tel +31 30 736591 
Fax+31 30 716963 
CIS 100041,2760 
Internet Niceware@let.ruu.nl 


The name Heip Perfect is used by permission of Noveii, inc. WordPerfect is a 
registered trademark of Novell, Inc. Help Perfect is a registered trademark of 
Niceware. Windows is a trademark of Microsoft Corporation. 
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Listing 1 continued 


else DateSeps[Index][x - 1] {6 chars from Win 3.0; keep 5} 

end; 
end; 

{bad sLongDate; make it MDY; else Date Order = value 1st given to it} 
if DateOrder = 0 then inc(DateOrder); 

if (MonthFormat < 1) or (MonthFormat > 4) then MonthFormat := 4; 
end; 
end; 


procedure tLongDateMainWin.ShowDateAndTime; 

var {for demo just concatenate each element into a single string} 

tempDate, tempYear, tempMonth, 
tempDay, tempDayOfWeek, tempHr, 
tempHour. tempMin, tempSecs, tempSecsl00 : word; 

DisplayStr : array[0..120] of char; 
tempStr : array[0..9] of char; 

{. .} 

procedure AddMonthCIndex : integer): 
begin 

with LongDateTimeRec do 
begin 

case MonthFormat of 

1. 2 : {1=3; 2=03} 

wvsprintf(tempStr, FormatStr[MonthFormat], tempMonth); 

3. 4 : begin {3=Mar; 4=March} 

StrCopy(tempStr, LongMonthNameArray[tempMonth]); 
if MonthFormat = 3 then tempStr[3] := #0; 
end; 

end; 

StrCat(StrCat(DisplayStr, tempStr), DateSeps[Index]); 
end; 
end; 

{ } 
procedure AddDay(Index : integer); 
begin 

with LongDateTimeRec do 
begin 

wvsprintf(tempStr, FormatStr[DaylChar], tempDay); 

StrCat(DisplayStr. tempStr); 

if Index <> 0 then StrCat(DisplayStr, DateSeps[Index]); 


Allen-Bradley Company 

Project 

Engineer 


DataMyte, adynamic business unit of Rockwell’s Allen-Bradley Company, 
has a challenging career opportunity in Minnetonka, MN for an engineer 
with an entrepreneurial approach to problem solving. 

In this role, you will be developing software for Windows 95, Windows 
NT, OLE and ODBC. Along with a BS in a technical or related field, the 
qualified candidate will possess at least 2 years C++ and windows 
programming experience as well as 7-10 years of intensive engineering 
training. 

As a leading provider of automated data collections systems, we offer an 
excellent salary, complete benefits and outstanding career growth potential. 
Please mail/FAX resume and salary requirements to: Rockwell 
International, Allen-Bradley Company, DataMyte Business Unit, 14960 
Minnetonka Industrial Road, Minnetonka, Minnesota 55345. FAX: 
612-935-0018. Equal Opportunity Employer. Principals Only. 


end; 

end; 

{.} 

procedure AddYearCIndex : integer); 
begin 

with LongDateTimeRec do 
begin 

if Year2Char then 

tempYear := (tempYear - ((tempYear div 100) * 100)); 
wvsprintf(tempStr, 'Xd\ tempYear); 

StrCat(DisplayStr, tempStr); 
if Index <> 0 then StrCat(DisplayStr, DateSeps[2]); 
end; 


end; 

{ } 
begin 

GetDate(tempYear, tempMonth, tempDay, tempDayOfWeek); 

GetTime(tempHour, tempMin, tempSecs, tempSecsl00); 
tempHr := tempHour; 
with LongDateTimeRec do 
begin 

if not Time24Hour then {12 hour; else use unmodified 24 hour} 

if tempHour mod 12 > 0 then tempHr := tempHr mod 12 
else tempHr := 12; 

wvsprintf(DisplayStr. FormatStr[HoursLeadingZero], tempHr); 

StrCattDisplayStr. TimeSep); {add hour & separator} 

wvsprintf(tempStr, FormatStr[2], tempMin); 

StrCat(StrCat(DisplayStr, tempStr). ’ ’); 
if Time24Hour then 

StrCat(DisplayStr, TimeTrailers[false]) 
else 

StrCat(DisplayStr, TimeTrailers[tempHour < 12]); 

StrCat(DisplayStr, ’ ’); 
if Day0fWeek3Char <> -1 then 
begin 

StrCopy(tempStr, LongDayNameArray[tempDayOfWeek]); 
if Day0fWeek3Char = 0 then tempStr[3] := #0; 

StrCat(DisplayStr. tempStr); 
end; 

StrCat(DisplayStr, DateSeps[l]); 
case DateOrder of 

1 : begin AddMonth(2); AddDay(3); AddYear(0); end 

2 : begin AddDay(2); AddMonth(3); AddYear(0); end 

3 : begin AddYear(2); AddMonth(3); AddDay(0); end 
end; 


{add min & space} 
{ex. EST or GMT} 
{ex. AM} 
{do Day of Week} 


{MDY} 

{DMY} 

{YMD} 


end; 

StrCat(StrCat(StrCat(DisplayStr, ’ [’), sLongDateStr), ']’); 
SetWindowText(hWindow, DisplayStr); {display as window caption} 

end; 


procedure tLongDateMainWin.wmWinIniChange(var Msg: tMessage); 
begin 

if (Msg.lParam = 0) 

or (StrComp(pChar(Msg.1Param), ’inti’) = 0) then 
begin 

ReadWinlni; 

ShowDateAndTime; 

Msg.Result := 0; 
end; 


procedure tLongDateMainWin.wmTimeChange(var Msg: tMessage); 
begin 

ReadWinlni; 

ShowDateAndTime; 

Msg.Result := 0; 
end; 

{ } 
procedure tLongDateApp.InitMainWindow; 
begin 

MainWindow := new(pLongDateMainWin, init(nil, ’LD Demo’)); 
end; 

{======================-===========} 

var 

LongDateApp : tLongDateApp; 


4L* Ro ckwell Automation 

Allen-Bradley • DataMyte 


begin 

LongDateApp.Init(’LDApp’); 
LongDateApp.Run; 
LongDateApp.Done; 
end. 

{ End of File } 
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sLongDate='_’ddd 


’mmmm’Jyyyy 

under Windows 3.0 (it should display as "_12"'"_Decem- 
ber_1994' under both). Since single quotes within separa¬ 
tors are not doubled by Windows 3.0, it is impossible to 
parse a Windows 3.0 sLongDate with 100% accuracy. 

The Demonstration Program 

The demonstration program in Iddemo.pas (Listing 1) 
reads the long date and time settings from win. ini, parses 
and formats them, and displays them (and the value of 
sLongDate as well) as the main window's caption. As it 
parses, it fills in LongDateTimeRec, which has fields for the 
separator strings, date-month-year order, and so on. Long¬ 
DateTimeRec is used to display the date and time and can 
be used for other purposes as well. For example, a listbox 
that allows users to select a month can display three-char¬ 
acter ("Jan") or complete month names ('January'), de¬ 
pending upon the value of LongDateTimeRec.MonthFormat. 
sLongDate does not have to be reread and reparsed every 
time information about the date or time formats is 
needed. Of course, LongDateTimeRec could be dynamically 
allocated and it could be global if other parts of a pro¬ 
gram besides the main window need access to it. 

The parser has two states: parsing a separator or pars¬ 
ing a picture element. If ParsingSep is FALSE, the parser 
scans until the current character is not equal to the first 
character, thus isolating one or more d's, m's, or y's and 
arriving at the beginning of a separator. When ParsingSep 
is TRUE, it is either single-quote delimited or not. If Quoted- 
Sep is TRUE, the end of a separator is signaled by the ap¬ 
pearance of a single quote that is not preceded or fol¬ 
lowed by a single quote (except under Windows 3.0); it 
will be preceded by a space and followed by a d, m, or y. 
When OuotedSep is FALSE, scanning continues until a d, m, 
or y is found. The month-date-year order is determined by 
placing an appropriate value in DateOrder the first time a 
month, date, or year picture is parsed. 

The parser determines which separator has been 
scanned by assuming that the first picture element en¬ 
countered will not be for the day of week; SepNum is set to 
1 (as if the day-of-week picture had just been isolated) 
and is incremented each time a month, date, or year pic¬ 
ture is parsed. If there is a day-of-week picture (which is 
always the first if it is there), SepNum is set to 0 so after 
parsing it will increment to 1. 

The Odd Case of sTime 

Although this article is mainly about the long date for¬ 
mat, there is a peculiar feature of the short time format 
you might also want to know about. sTime, the 'character' 
used to separate hours from minutes and seconds, is also 
handled oddly by Control Panel. The applet dialog box 
lets the user type the separator in a small edit box. You 
might expect the edit box to limit you to a single charac¬ 
ter, or to two characters. In fact, the edit box limits the 
number of separator characters based on the widths of 
the characters you choose. For example, you can only en¬ 
ter one "fat' character (such as a "w"), but you can enter 


as many as three "skinny" characters (such as a '[')! No 
spaces are added to sTime. it should always be safe to 
read a single character for sTime from win. ini. 

Windows 3.0 Problems 

The Windows 3.0 International Control Panel applet 
will accept almost any input from a user and write sLong¬ 
Date to win. ini, but it may crash when it attempts to parse 
sLongDate if the user later attempts to edit the long-date 
format. Iddemo.pas (Listing 1) deals with the Windows 3.0 
sLongDate in three ways. 

• if ReadProfileString returns a value greater than 53, the 
maximum length of a Windows 3.1 x sLongDate when 
reading from win. ini, a default sLongDate string is substi¬ 
tuted. 

• The parser assumes single quotes will be doubled 
when sLongDate is written to win. ini (3.1 x format); thus, 
it will 'eat' some single quotes inside a Windows 3.0 
single-quote-delimited separator. 

• Defaults are established for Day0fUeek3Char, DaylChar, 
and Year2Char, and the three separators. After parsing 
they cannot contain incorrect values, although any of 
them might not appear in a faulty sLongDate and thus 
new values might not be parsed into them. 

Setting defaults ensures that the application will not 
crash and that LongDateTimeRec will contain acceptable val¬ 
ues (if not those the user set). The value of MonthFormat 
must be checked after parsing because a faulty sLongDate 
might contain 5 or more m's. I don't think these tactics 
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are unreasonable since Windows B.O 
is several generations old. Because of 
the need to deal with Windows B.O 
and the desire to lay out the parser 
as clearly as possible, the demonstra¬ 
tion program is not as short or effi¬ 
cient as it could be. 

If you need or would like to make 
use of the Windows long date format 
and your application must be back- 
wardly compatible with Win 3.0, you 
have three choices. When your appli¬ 
cation determines that it is running 
under Windows 3.0, it can check 
sCountry in win. ini and substitute ap¬ 
propriate default strings for each 
country (difficult). It can always sub¬ 
stitute the same correct, default 
sLongDate string (easier). It can incor¬ 
porate a version of the parser in 
Iddemo.pas (Listing 1) (easiest). The 
parser correctly decodes a Windows 
3.1 x sLongDate entered via Control 
Panel's International applet (it is al¬ 
ways possible for a user to turn 
sLongDate into garbage by modifying 
it directly in win. ini) and most Win¬ 
dows 3.0 sLongDate s. It may not prop¬ 
erly parse a Win 3.0 sLongDate that 
contains single quotes in a separator, 
but it will not crash as the Windows 3.0 Control Panel 
sometimes does. 

Author's Update: A Date Problem with Delphi 

Borland's Delphi does not handle Windows' dates cor¬ 
rectly. The SysUtils unit (included in almost every applica¬ 
tion) reads and parses the time, date, and currency for¬ 
mats from win. ini upon application startup and stores the 
information in several variables - a nice feature. Develop¬ 
ers can use several functions to display the date and time 
according to the settings the user has established via Con¬ 
trol Panel; for example, 

Caption := FormatDate Time(ShortTimeFormat + ''+ LongDate Format, Now) 

However, Delphi completely ignores single quotes users 
have included as separators and it doesn't correctly han¬ 
dle implied spaces. Most importantly, its LongDateFormat 
string variable is only 31 characters long, and this can re¬ 
sult in an incomplete date being displayed. Delphi will not 
crash when parsing the date and time settings from 
win. ini (since it doesn't run under Winodws 3.0). Borland 
has been notified of the problem. If you use Delphi's Long¬ 
DateFormat to display dates, you may have to handle calls 
from users wanting to know why your application doesn't 
display the entire date or why it doesn't display the date 
"the way Windows does." □ 
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The visual and easy way 
to create and edit Windows help files! 


Did you ever need to change a WinHelp help file 
or print more than one topic at a time? 

Now you can - with Help Writer’s Assistant, 
the stand-alone true WYSIWYG help editing tool. 


HWA is a powerful, yet very user-friendly help editing tool. You will love features like: 

• Import existing help files for editing! (decompile). Everything in the original file is preserved 

• Topic tree that helps navigate through the help files topics and see the structure at a glance 

• Visual editor with multiple fonts, colors, styles, justification, indentation, borders, 
tables, paragraph and line spacing. Pictures and some embedded windows 
are also displayed in the visual editor 

• Drag and Drop is employed throughout the product to make many tasks easier! 

• Integrated spell checker 
and thesaurus 


UMMI.WM.-I 

Iopic Project Formal insert Window Help 


> Visual Button-Bar designer 

Order HWA 
for just $199 


iHyperAc 



MHi3HAte.TBl[Tft?l 


B F^SI f—lit !»MW»I 


Welcome to Long Haul Rail. - your kind 
of shipping company!!! 


General * | Entry Macros | Build Tags Keywords ] f<|> 


|Welcome to Long Haul Rail 
Duplicate in Non-Scioiing region 


t Copy Title to Context Stnnq 


to Long Haul H/ 



P.O.Box 5517, Coralville, IA 52241, USA 
TeleFax. (319) 351-8413. CompuServe 76350,333 
Internet: rhalevi@hyperact.com 
Home Page: http://www.hyperact.com 
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Windows 3.1 SDK 


file Edit Bookmark Help 

Jss+l ...jack lHr.jo.yJ -i— J JbteZU 




DDEDATA (2.x) 


& 

^include <dde.h> 

typedef struct tagDDEDATA { 
WORD unused;12. 

£ Response:1. 
fRelease 1. 
reserved 1. 
f AckReq 1. 


/* ddedat */ 


In this help topic, the description for the {Response field actually 
describes the fAckReq field, and vice versa. 

Submitted by Sudhir Menon. 

Reference: Microsoft Knowledge Base article Q93372. 

(SDK Annotation == free T-shirt! Send your idea to 
70302.2566@compuserve.com. Get complete annotation file from 
locations listed in table of contents, or file sdkann.zip from Library 7 
(RID Publications) of forum SDFORUM on CompuServe ! 
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Please send us your best tricks and 
hacks - those clever pieces of code to 
make things work the way they 
should! You'll receive at least $50 for 
each tip that we print 

Send your submissions: 

- via the Internet to: 
leor@bdsoft.com 

- from CompuServe to: 
>INTERNET:leor@bdsoft.com 

- or by regular mail to: 

Leor Zolman 

74 Marblehead Street 
North Reading, MA 01864 



Closing Zombie Windows 


Jason M. Rinn 
rinn@cs.ucf.edu 



Visual C++ vl .5 

eH3= 

■ Borland C++ v4.5 

Symantec C++ v7.D 
Watcom C++ vIO.O 


Has this ever happened to you? You're trying to write your latest, greatest 
Windows application, and you're doing a special window style, and it goes 
wrong. You create a window you cannot destroy! Of ail the reasons I've ever 
had to restart a Windows session, or reboot, this has to be the most frustrating. 
You can see the window, but you can't double-click it closed. Task Manager 
can't even close it. And you can't recompile until it's gone. (In my more para¬ 
noid late night moments, I can almost hear it laughing at me.) 

Well, a solution does exist, even if you forgot to run under the debugger. 
Undocumented Windows (Andrew Schulman, et al.) has enough little programs 
included on disk to do the job, if you don't mind the hassle. First, you run 
WINTASK or WINWALK to find the task handle for the application you wish to 
end, or 'kill.' A task handle is actually a selector to information about each 
task, which the Windows scheduler uses to switch from task to task by keeping 
track of such information as stack location and current directory. It's different 
than an instance handle, which is assigned to every module loaded, even DLLs 
(which have no stack). 

Once you have your task handle, you pass it (as a hex number) as a com¬ 
mand-line parameter to KILL. KILL uses a function called TerminateAppO to treat 
your application as if it had caused a UAE or General Protection Fault; the only 
difference is that it uses an option that does not put up an error box. This is 
the one way to make sure a task is stopped. 


Leor Zolman is a consultant specializing in C programming training, an instructor on 
UNIX topics for Boston University's Center for Information Technology, and “Tech Tips" 
editor for Windows/DOS Developer's Journal. His book, Illustrated C, was published in 
1992. He may be contacted at 74 Marblehead St., North Reading, MA 01864. Internet 
address: leor@bdsoft.com. 





















Programmer's Cleanup 


SNAGIT 
Wl NOLDAP 
PSP 

FRONTRUN 

TASKCLN 



Close 


Kill Task 


Refresh 


Figure 1 taskcln in action 


Listing 1 taskcln.c 


/* taskcln.c "Clean" a running task using TerminateApp. 

* List all tasks in a list box, 

* and allow user to select by button or double click. 

* by Jason H. Rinn 10/24/94 

* NOTE: This code was written assuming smart callbacks, 

* -OSTRICT, and large memory model. 

*/ 

(/include <windows.h> 

//include <toolhelp.h> /*For TaskFirst.TaskNext,TerminateApp*/ 
//include <stdlib.h> /*For malloc*/ 

//include "taskcln.h" /*For Dialog Box constants*/ 

fifdef _WATCOMC_ 

//pragma off (unreferenced): 

#endif 

/*Name of Dialog box resource*/ 

//define DIALOGNAME "TaskClean” 

HTASK hTaskList[256]; /* Array of handles of running tasks.*/ 
/*Lists module names of 

‘currently running tasks in listbox ID_TASKL1$T*/ 
void RefreshList(HWND hDlg) 

{ 

TASKENTRY te; 
int iCount=0; 

SendDlgltemMessagefhDlg. ID_TASKLIST, 

LB_RESETCONTENT, 0, 0): 
te.dwSize=sizeof(TASKENTRY); 
if (TaskFirst(&te)) 

{ 

do 

{ 

hTaskList[iCount++]=te.hTask; 

SendDl gltemMessagefhDlg, ID_TASKLIST, LB_ADDSTRING, 
0, (DWORD)(LPSTR)&te.szModule): 

} while (TaskNext(ite)); 

} 


/* End task selected in list box ID_TASKLIST using 
* TerminateApp. Then, relist task modules. */ 
void KillTasktHWND hDlg) 

{ 

DWORD dwCurSel, dwTextLen; 

LPSTR IpszCurSel; 


Since this is a complicated procedure for such a simple 
task, I've written my own solution, taskcln.c (Listing 1), 
taskcln. rc (Listing 2), taskcln.h (Listing 3), and taskcln. def 
(Listing 4) implement a short program that lists all running 
tasks by their module name in a listbox, as shown in Figure 1. 


Listing 1 continued 


dwCurSel = SendDlgltemMessaget hDlg, ID_TASKLIST, 
LBJETCURSEL, 0, 0); 
dwTextLen * SendDlgltemMessaget hDl g, ID_TASKLIST, 
LB_GETTEXTLEN, 0, 0): 

/‘Allocate string for safety (+1 for terminating NULL*/ 
IpszCurSel = (LPSTR) malloc((size_t)dwTextLen+l); 

/‘And check return value.*/ 
if (IpszCurSel!=NULL) 

if (IsTask(hTaskList[dwCurSel])) 

TerminateApp(hTaskList[dwCurSel], N0_UAE_B0X); 
RefreshList(hDlg); 


/‘Dialog Box Procedure.*/ 

BOOL CALLBACK CleanProcOiWND hDlg, UINT wMsg, WPARAM wParam, 
LPARAM IParam) 


{ 

switch(wMsg) 

{ 

case WMJNITDIALOG: 

RefreshList(hDlg): 
break: 

case WM_CL0SE: 

EndDialogthDlg, TRUE); 
break: 

case WM_C0MMAND: 
switch(wParam) 

{ 

case ID_REFRE$H: 

RefreshList(hDlg); 

break: 

case IDJCILLTASK: 

KillTask(hDlg); 

break: 

case ID_TASKLIST: 

if (HIWORDdParam)==LBN_DBLCLK) 
KillTask(hDlg); 
break: 

case IDCANCEL: 
case IDOK: 

EndDialogthDlg, TRUE): 
break: 

} 

break: 

default: 

return FALSE: /*If not handled in switch. */ 


return TRUE; /*If handled in switch*/ 

} 


(fifdef_BORLANDC_ 

#pragma argsused 
//endi f 

int PASCAL WinMain(HINSTANCE hlnstance, 

HINSTANCE hPrevInstance, LPSTR IpszCmdLine, int nCmdShow) 

{ 

return DialogBoxthlnstance, DIALOGNAME, (HWND)NULL, 

(DLGPROC) CleanProc): 


} 


/* End of File */ 
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If you select a task and then press the 'Kill Task' button, 
or if you just double-click on a task name, the program 
will terminate that task. The code disk (see Table of Con¬ 
tents for availability) also contains bldtask.bat, a batch file 
that contains the commands to compile the program with 
either Borland C++ v4.5, Symantec C++ v7.0, Visual C++ 
vl .5, or Watcom C++ vl 0.0. 

This program is interesting for a few reasons. The first 
is that it uses toolhelp.dll. If you've never used it before, 
you'll see that Microsoft loves the xxxFirst and xxxNext 
style of function calls it started way back in DOS. Also, the 
documentation is not clear, but the only way I've ever 
seen TaskFirstO return an error is if you forget to initialize 
the dwSize member of your TASKENTRY structure. As you'll 
see, I don't even bother to zero out the TASKENTRY structure, 
though many books suggest it. If anyone sees TaskFirstO 
return an error, I'd like to hear about it. 

The documentation for TerminateAppO leaves out one 
interesting side effect that results if you try to kill a task 
that no longer exists. For example, if you start taskcln.exe, 
then switch to and exit one of the tasks it displays, then 
return to taskcln.exe, it will still display (assuming you 
don't press the 'Refresh' button) the task you exited nor- 


Listing 2 taskcln.rc 


♦include <windows.h> 

♦include "taskcln.h” 

TaskClean DIALOG 18, 18, 142, 92 
STYLE DS_L0CALEDIT I DSJODALFRAME I WS_OVERLAPPED | 
WSJISIBLE I W$_CAPTI0N I WSJYSMENU I WS_MINIMIZEBOX 
CAPTION "Programmer's Cleanup" 

BEGIN 

CONTROL ID_TASKLIST, "LISTBOX”, LBSJOTIFY I 

LBSJASSTRINGS I WSJHILD I WSJISIBLE I 
WSJORDER I WSJSCROLL, 3, 2, 79, 90 
DEFPUSHBUTTON "Close", IDOK, 100, 12, 24, 14, WSJHILD | 
WSJISIBLE I WSJABSTOP 

PUSHBUTTON "Kill Task", IDJCILLTASK, 94. 37, 36. 14. 

WSJHILD I WSJISIBLE I WSJABSTOP 
PUSHBUTTON "Refresh". ID_REFRESH, 96. 63. 33, 14. 

WSJHILD I WSJISIBLE I WSJABSTOP 


Listing 3 taskcln.h 


♦define IDJASKLIST 101 
♦define ID KILLTASK 102 
♦define ID_REFRESH 103 


Listing 4 taskcln.def 

NAME 

taskcln 

DESCRIPTION 

’Program for ending tasks which do not close otherwise.’ 

EXETYPE 

WINDOWS 

STUB 

’WINSTUB.EXE’ 

CODE 

PRELOAD MOVEABLE DISCARDABLE 

DATA 

PRELOAD MOVEABLE MULTIPLE 

HEAPSIZE 

1024 

STACKSIZE 

8192 


mally. However, if you then select that task and press the 
'Kill Task' button, taskcln.exe will try to 'kill' a task which 
doesn't exist. Consequently, taskcln will get 'killed' by a 
General Protection error. To avoid this, make sure to keep 
the IsTaskO call to verify that the task handle is valid. 
Check out Undocumented Windows for IsValidTaskO, a 
homemade implementation of IsTaskO, if you need your 
program to work under 3.0. 

Be aware that TerminateAppO does not take care of 
everything. For one thing, it will not recover GDI or USER 
resources, and so permanently reduces free resources. 
And I've not figured out exactly why, but it is possible to 
hang Windows completely. I think it has to do either with 
tasks that have hooks set or otherwise shouldn't be killed, 
or with killing too many tasks at once - the system al¬ 
ways locks when I just start killing tasks at random. But it 
is sometimes your only chance to continue. 

I originally wrote this program under OWL 1.0 with 
Turbo C++ for Windows, but I wanted to reach a larger 
audience. I was surprised at how simple it was with a dia¬ 
log box as a main window. It pleases me that I've man¬ 
aged once again to write a program without a message 
loop. 

Well, that's one Windows programming problem 
solved. Now if someone could tell me what is going on 
when the Turbo C++ IDE suddenly gets enormous scroll 
bars and Program Manager refuses to launch a program 
on a double-dick ... 


TWAIN Integration Kit" 



The TWAIN Integration Kit for Windows applications supports 
this and hundreds of other scanners. It is easy, fast and power¬ 
ful. No other scan or imaging toolkit provides this many TWAIN 
functions. Simple - if you want, complex - if you need. Standard 
and Professional versions available. 16 bit and 32 bit versions 
available. TWAIN support for your Windows application in a day 
or less - no problem with the TWAIN 


Call now! 


CompuServe. Download I IKDIM.ZIP 
from WINSDK !<*rum, section Public Utilities. 


North and South America: ELSEWHERE: 

European Software Connection JUNGCLAUS SOFTWARE ENGINEERING 

1617 St. Andrews Drive P.O. Box 270 202 


Lawrence. KS 66047 
Phone: 800-986-6578 
or 913-832-20 7 0 

Fax: 913-832-8787 

CompuServe 71 141,3634 

□ Request 


40525 Duesseldorf 
German} 

Phone: +49 211504 84 79 
Fax: +49 211562 3112 

CompuServe 100334,2207 

Service #222 □ 
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Using Global Atoms to Pass Strings 
between 32-Bit Applications 


Paula Tomlinson 
paulat@microsoft.com 


Many articles have been written in the last year or two 
warning developers about using memory-mapped file 
techniques to share memory between processes in Win¬ 
dows 95 and Windows NT. But sometimes processes only 
need to communicate simple information, such as a file¬ 
name, and memory-mapped files (in any form, such as 
named shared memory, named pipes, OLE, etc.) seem like 
overkill here. Even when the data being communicated 
warrants memory-mapped files, there is still the problem 
of communicating the name of this "named' shared mem¬ 
ory. Many people resort to hard-coded names and a few 
put the names in some private key in the registry - but 
then there's the issue of hard-coding the name of the reg¬ 
istry key! A much simpler, yet often overlooked, method 
for passing strings between processes is using global at¬ 
oms. Yes, global atoms can still be used on Windows 95 
and Windows NT to identify strings across process 
boundaries. In case you're rusty on using the global atom 
table, I wrote two simple programs to demonstrate this 
technique - the key excerpts are in Figure 2 and Figure 3. 



NO MORE CARDS! 

NO MORE MAILING! 

THIS IS SIMPLE! 

THIS IS FAST! 

Don’t mail that Reader Service 
Card; e-mail us instead. We’ll take 
care of the rest! 


wdrs@rdpub.com 

<Reader service number> 
clssue date or number> 

Name 

Address 


Now that’s easy! 


Windows/POS 

□ DEVELOPER'S JOURNAL 


The first application (excerpted in Figure 2), send.exe, 
defines a string called "paulat". During UM_CREATE process¬ 
ing for its main window, it adds this string to the global 
atom table by calling GlobalAddAtomO. When the "Send" 
menu item is selected, the program sends a message to 
the cooperating application, recv.exe. Atoms are 16-bit 
quantities in Windows 3.x, Windows 95, and Windows 
NT, so I can use the wParam parameter to send the atom to 
either a 16-bit or 32-bit application. I use IParam to com¬ 
municate the size of the data I'm sending. I could use dif¬ 
ferent custom messages to distinguish between types of 
transfer if I wanted to send different kinds of data to the 
same application. When send.exe is destroyed, it frees the 
global atom by calling Global Del eteAtomO. 

The receiving application (excerpted in Figure 3), 
recv.exe, upon receipt of the user-defined UM_SOMETEXT mes¬ 
sage, allocates enough memory for the string (based on 
the IParam value) and retrieves it by calling GlobalGetAtom- 
NameO. That's all there is to it. When you just need to pass 
a short string between separate processes, global atoms 
can provide a simple and effective solution. □ 


Figure 2 Defining a string called “paulat" 

send.c 


ATOM gAtom; 

char szString[128] = "paulat"; 


case WM_CREATE: 

gAtom = GlobalAddAtom(szString); 
break; 


case WM_COMMAND: 
switch (msgID) { 

case IDM_SEND_FILENAME: 

dwSize = (strlen(szString) + 1) * 
hRecv = FindWindowCIPC Recv Class 
if (hRecv 1= NULL) 

SendMessagethRecv, UMJOMETEXT, 
break; 

sizeof(CHAR); 

", NULL); 

gAtom, dwSize); 

case WMJESTROY: 

GlobalDeleteAtom(gAtom); 

PostQuitMessage(O); 

break; 



Figure 3 Allocating memory for the string 


Frecv.c 

switch (msg) { 
case UMJOMETEXT: 

{ 

HGLOBAL hMem = GlobalAlloctGHND, IParam); 

LPSTR IpString = GlobalLock(hMem); 

G1obalGetAtomNameC(ATOM)wParam. IpString, IParam); 
MessageBoxOlWnd, IpString, "Receiving App", MB_OK); 
GlobalUnlock(hMem); 

G1obalFree(hMem); 
break; 

} 
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Bug++ of the Month 


Mark Nelson 


Mistakes are a fact of life. 

It is the response to error that counts. 

- Nikki Giovanni, Black Feeling/Black Talk/Black Judgement 

One thing C and C++ programmers take for granted is 
that their compiler will be able to perform various type 
conversions in a silent and undemanding fashion. In the 
simple days when ail we had were K&R compilers on 
UNIX systems, this was a relatively straightforward matter. 
The portable C compiler that was shipped with most UNIX 
systems was more than happy to silently convert pointers 
to ints, ints to chars, chars to floats, and so on. 

As the C language progressed, it made sense to lay 
down a few rules regarding type conversions, starting with 
the ANSI C standard. When C++ programmers gained the 
ability to create completely new data types, clarification in 
this area became even more important. The draft ANSI 
C++ specification now includes an entire chapter (albeit a 
short one) on Standard Conversions. The rest of the speci¬ 
fication is riddled with additional comments and notes re¬ 
garding type conversions. 

This Month's Suspect 

Exceptionally creative W/DDJ reader Rick Siadkey man¬ 
aged to find an example of a program where Borland's 
v4.5 C++ compiler goes through a truly bizarre set of type 
conversions in order to do its job. bug0895.cpp (Listing 1) 
shows a program that really only does one thing in 
mainO: it tests to see if a variable called Value is true or 
false, and prints the appropriate result. 


The draft C++ specification has a set of rules, collec¬ 
tively referred to as "the usual arithmetic conversions,' 
that should be followed in this case. My reading of the 
arithmetic conversion rules tells me that the expression: 

if ( Value ) 

in bug0895.cpp should cause an immediate conversion of 
Value to int, followed by a test of the resulting integer 
against 0, yielding a Boolean result. If things worked that 
way, you would see output from bug0895.exe that looked 
something like this: 

C> BUG0895 
Value is true 
C> 

But instead, you see this sequence: 

C> BUG0895 
foo(0) 
food) 
foo 1 != 0 
Value is true 
-food) 

—f00(0) 

C> 


Mark Nelson is a programmer for Greenleaf Software and a student at the University of Texas at Dallas. Mark is the author of The 
Data Compression Book and Serial Communications: A C++ Developer's Guide, both from M8T Books. You can reach Mark 
on CompuServe at 73650,312. 
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This makes no sense at all! There isn't any obvious place 
in the program where an object of class foo is being in¬ 
stantiated. Even worse, why is a comparison being per¬ 
formed on the two foo objects created for unknown rea¬ 
sons? 

Step into My Parlor... 

In the case of this puzzle, why the compiler is behaving 
this way isn't readily apparent. However, compiling and 
executing a few test programs at least sheds some light 
on what the compiler is actually doing. It seems that Bor¬ 
land's compiler realizes it needs to compare Value to 0 in 
bug0895.cpp. Instead of doing this by directly converting 
Value to an int (which would seem to be what the spec 
demands), Borland C++ 4.5 decides instead to convert 
Value to an object of type foot). Naturally, since it has to 
perform a comparison, it creates a second foo object out 
of the integer 0. The foo version of operator—!) is then 
called to test the objects, and the temporary foo objects 
get destroyed. 

This is certainly odd behavior, but there is something 
even more peculiar going on here. The only way to pro¬ 
voke Borland C++ 4.5 into making this bad error in judg¬ 
ment is to create a prototype for operator] () for an addi¬ 
tional enumerated type. In bug0895.cpp, the additional type 
is enum NotUsed. This enumerated type acts as a catalyst for 


the bug. Even though it is never used, its mere presence 
in the program causes BC++ v4.5 to perform a faulty con¬ 
version. Remove the two lines referencing enum NotUsed, 
and the program starts working properly again! 

The Official Response 

Borland's response doesn't shed any additional light on 
why the problem is occurring, whether it can show up in 
other places, or when it will be fixed: 

We have verified the bug you reported. It will be fixed in a 
future version of Borland C++. 

By the time you read this article, you should have your 
update copy of Borland C++ v4.51. If we re all lucky, the 
bug will be fixed in this minor upgrade. If not, just be sure 
to keep a careful eye on your code anytime you create 
operator 1 0 for a user-defined type! 

Fame and Fortune Await 

Rick Sladkey is going to be the envy of his coworkers 
when he walks in wearing his new W/DDJ t-shirt. You too 
can turn heads in this imperial purple fashion statement. 
Just send in your most interesing C++ bugs to Mark Nel¬ 
son at wdletter@rdpub.com. If we use yours in a future 
issue of W/DDJ, a shirt will show up in your mailbox long 
before the compiler update that fixes the bug! □ 


Listing 1 bug0895.cpp — Arithmetic conversion problem in Borland C++ v4.5 

II 

public: 

II This program demonstrates an arithmetic conversion 

const int val ; 

// problem found in Borland C++ 4.5. Both the 16- and 

foot int i = -1 ) : val C i ) { 

// 32-bit compilers run into problems when trying to 

cout « "foot" « i « ")\n"; 

// test the enumerated variable Value in the if 

} 

// statement in main. 

-foot) { 

II 

cout « "-foot" « val « ")\n": 

II For unknown reasons, the compiler decides to test 

} 

// Value by converting both Value and 0 to type foo, 

}; 

// then using the operator==() defined for objects 
// of type foo. This results in output that looks 

int operatorN const foo &a, const foo &b ) 

// like this: 

{ 

// 

cout « "foo " 

// C> BUG0895 

« a.val 

// foo(0) 

« " != " 

// food) 

« b.val 

// foo 1 != 0 

« "\n"; 

// Value is true 

return a.val != b.val ; 

// -food) 

} 

// ~foo(0) 

// c> 

enum { a = 1, b = 0 } Value = a; 

II 

II The output should look like this: 

enum NotUsed; 

II 

int operator! ( NotUsed, NotUsed ); 

II C> BUG0895 
// Value is true 

int maint) 

// C> 

{ 

II 

if ( Value ) 

f/include <iostream.h> 

cout « "Value is true\n"; 
return 0; 

} 

// End of File 

class foo { 
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New Products 

Industry-Related News & Announcements 


SQA TeamTest Gets SQLWindows Support 


SQA Inc. has released SQA TeamTest v3.1, the latest 
version of their automated client/server testing tool for 
Windows. The product is designed to integrate test plan¬ 
ning, test development, test execution, results analysis, 
defect tracking, and summary reporting and analysis. 

You can use SQA TeamTest to test any Windows applica¬ 
tion, but it offers special integration with PowerBuilder 
and other major client/server development tools. 

This version of the product features enhancements to 
SQA's 'object-oriented recording" that allows data to be 
tested independent of its row and column location. This 


Bricklin DLL Handles Spatial Display 

Software Garden, Inc., is now shipping Dan Bricklin's 
OverAII DLL, a library that helps your application provide 
both an overall view and detailed views of data, using 
bitmapped images. When the user drags the mouse on 
the overall view, the detailed views follow smoothly. 
Data is displayed spatially as icons or text. You can drag 
and drop to create new data items. The DLL runtime is 
royalty-free. 


version supports SQLWindows v5.0, and treats Table 
Window rows and columns as objects for location-inde¬ 
pendent testing of Table Windows. Menu items are now 
treated as objects, and SQA TeamTest tests their content, 
state, or accelerator keys independent of each item's lo¬ 
cation. Clipboard rows can also be tested independent of 
location. 

SQA TeamTest v3.1 costs $2,495 per seat. For more 
information, contact SQA, Inc, 10 State Street Woburn, 
MA 01801, (800) 228-9922; fax (617) 932-3280; 
info@sqa.com. 


The OverAII DLL is bundled with the OverAII Viewer 
authoring system for $495; if you already own the Over- 
All Viewer, you can upgrade for $100. For more informa¬ 
tion, contact Software Garden, P.O. Box 373, Newton 
Highlands, MA 02161, (800) 745-6101 or 
(617) 332-2240; fax (617) 965-8983. 


Updated DOS GUI Features Built-In Scrolling 


TWS has released the latest version of their GUI li¬ 
brary for DOS and extended DOS. TWS helps DOS pro¬ 
grammers give their application a GUI that includes 
features such as multiple overlapping, scrollable win¬ 
dows, that can be moved, resized, or iconized; controls 
such as buttons, labels, radio buttons, sliders, scrollbars, 
editable strings, lists, menus, and pixmap images; back¬ 
ground processing; and color, font, and cursor manage¬ 
ment. The latest version features built-in scrolling for 
window contents, a 'hotregion' control for placing arbi¬ 


trarily shaped interactive regions over graphics, new 
decorative 3-D panels and divider line elements, transpar¬ 
ent controls, menu accelerator keys, improved font and 
cursor management, and a revamped event handling sys¬ 
tem. 

The TWS graphical user interface library for DOS and 
extended DOS costs $159, requires the MetaWINDOW 
graphics library, and includes C source code. For more in¬ 
formation, contact TWS, P.O. Box 37464, Albuquerque, 

NM 87176, 71160.2426@compuserve.com. 
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Support Database/Spreadsheet Output with DataExport Engine 


Spalding Software, Inc., has released the DataExport 
Engine, a new product that lets developers export data 
from their Windows applications into 37 spreadsheet 
and database formats. Supported formats include Excel, 
Access, Lotus 1 -2-3, Paradox, and dBase-compatible for¬ 
mats. The engine uses an ASCII source file and an export 
definition file (EDF) for conversion of data, and is based 
on technology developed for the company's text conver¬ 
sion utility, Datalmport. 


The DataExport Engine costs $795 and is royalty-free. 
For more information, contact Spalding Software, Inc, 
Technology Park/Atlanta, 154 Technology Parkway, 

Suite 250, Norcross, GA 30092, (404) 449-1634; 
fax (404) 449-0052; CompuServe: 74431,240; 

Internet: DE-info@spaldingsoftcom. 


Buliseye Updates C/C++ Branch Coverage Analyzer 


Bullseye Software has released C-Cover v3.0, the lat¬ 
est version of their branch coverage analyzer for C and 
C++. C-Cover helps testers locate untested control struc¬ 
tures, functions C++ classes, source files, and sub-sys¬ 
tems. A new feature can force execution flow through 
specified branches, allowing testing of error conditions 
that are difficult to reproduce. C-Cover can analyze multi¬ 
threaded code, DLLs, device drivers, and system-level 
code. The product is designed to handle very large pro¬ 


jects and includes the ability to sort, filter, and summa¬ 
rize large amounts of coverage data. C++ is supported, 
including inline functions, templates, and exception han¬ 
dling. 

C-Cover for Windows costs $800 for the first copy 
and $700 for each additional copy. For more informa¬ 
tion, contact Bullseye Software, 5129 24th Ave NE, Ste 9, 
Seattle, WA 98105-3230, (800) 278-4268; 
fax (206) 524-3575; email: info@bullseye.com. 


Scientific Endeavors Enhances Graphing Library 


Graphic is a platform-independent, high-resolution 
graphics C library for displaying scientific and engineer¬ 
ing graphs. The library includes over 240 functions and 
supports linear and logarithmic X-Y plots, 3-D surfaces, 
polar charts, pie charts, bar charts. Smith charts, and nine 
different curve types with varied curve thickness and six¬ 
teen different curve markers. Three-dimensional surfaces 


are shaded to allow color changes at contours of con¬ 
stant height or in colored ribbons along grid lines. 

Graphic costs $465 for DOS and $495 for all other 
platforms. For more information, contact Scientific 
Endeavors Corporation, 508 North Kentucky St, Kingston, 
TN 37763, (800) 998-1571 or (615) 376-4146; 
fax (615) 376-1571. 


Drag-it/VBX Gains Delphi and Gupta Support 


Drag-it/VBX is a custom control that lets program¬ 
mers add custom toolboxes to their Windows applica¬ 
tions. You can create Drag-it toolboxes by drawing or by 
importing bitmaps using Drag-it Builder. Users can enter 
data by dropping symbols from the toolbox onto the 
form, and can show relationships by connecting the sym¬ 
bols. The new version supports Borland's Delphi and 
Gupta's SQL Windows, as well as Visual Basic. New fea¬ 
tures include the ability to programmatically change tool- 


WinRT Now Available for Windows 95 

The WinRT Tool Kit is a set of tools that helps Win¬ 
dows NT programmers access hardware without having 
to write device drivers. A compatible version of the 
toolkit is now available for Windows 95. You can use 
WinRT to write programs that directly perform port I/O, 
memory-mapped I/O, and access interrupts without us¬ 
ing the Microsoft DDK. Your application can use the 
same source code to access hardware under both Win¬ 
dows 95 and Windows NT, even though the two operat¬ 
ing systems use entirely different models for device 


boxes, add and delete symbols from the application, 
save or open the diagram from the application, connect 
lines with arrowheads, create non-moveable labels, 
stretch symbols, move symbols, and create an event that 
fires when the user double-clicks on a connecting line. 

Drag-it/VBX costs $295. For more information, con¬ 
tact Performix, 6618 Daryn Drive, Westhills, CA 91307, 
(800) 337-2448 or (818) 992-0840;fax (818) 347-9455. 


drivers. The WinRT device driver (implemented as a set 
of VxDS under Windows 95 and as a kernel-mode de¬ 
vice driver under Windows NT) does the work that can¬ 
not be accomplished by user-mode code. 

The WinRT Tool Kit costs $395, but has an introduc¬ 
tory price of $295. Upgrades for users of the NT version 
cost $195. For more information, contact BlueWater 
Systems, 144 Railroad Ave, Suite 217, Edmonds, WA 
98020; (206) 771-3610;fax (206) 771-2742; 

73514.132@compuserve.com. 
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GUI Interface for GNU Debugger Available 


Cygnus Support has created a GUI interface to the 

GNU debugger (GDB) that provides a common graphical 
interface for debugging across the more than 65 plat¬ 
forms the company supports, including UNIX platforms 
under the X Window system, Windows 3.1, and cross¬ 
platform configurations running Windows NT. 

GUI GDB can connect any command to its own win¬ 
dow, and the command results will be kept current. The 
product offers a dynamic, multi-window environment 
that provides interleaved source/assembly views and dy¬ 
namic highlights of changing values (registers, expres¬ 
sions, etc.). A command window offers the standard 

command-line interface to GDB for backward compatibil¬ 
ity. The program includes keyboard shortcuts for com¬ 
mon operations and online help. Source code is included. 

The Cygnus GUI for GDB is included with the Cygnus 

Developer's Kit, starting at $1,995. The Developer's Kit in¬ 
cludes a C compiler, debugger with GUI, assembler, 
linker, documentation, source code, support, and four up¬ 
dates per year. For more information, contact Cygnus 

Support, 1937Landings Drive, Mountain View, CA 94043, 

(800) 294-6871 or (415) 903-1400; fax (415) 903-0122; 
info@cygnus.com. 


Artie Software Ships Calendar Custom Control 


The Kalendar is a new VBX from Artie Software. The 
control features 20 events that let you customize the day 
boxes, draw your own calendar day boxes, and draw di¬ 
rectly on the day boxes. You can also draw text, bitmaps, 
and other information directly on top of the day boxes. 

Over 100 properties give developers features such as 

multiple views, international formats, 12 built-in lan¬ 
guages, data aware, 3-D, graphic wallpaper, and printing 
support. 

The Kalendar VBX costs $69. For more information, 
contact Artie Software, P.O. Box 28, Waterford, Wl 

53185-0028, (414) 534-4309;fax (414) 534-7809. 


ObjectUtilities Provides Image Processing Capability 


ObjectUtilities is a programmable image processing 
system you can use to add image processing capabilities 
to your Windows application. Bi-tonal, color, and 
grayscale images can be scanned, viewed, marked-up, 
faxed, printed, emailed, enhanced, formatted (TIFF, PICT, 
etc.), annotated, redacted, and noted. The product offers 
both a C API and an OLE 2 interface. 

ObjectUtilities costs $199 per desktop. For more infor¬ 
mation, contact Optical Technology Croup, Inc, 

One Democracy Plaza, Suite 805,6701 Democracy Blvd., 

Bethesda, MD 20817, (301) 897-1400;fax (301) 897-1415. 


Blue Sky Ships Comprehensive WinHelp Office 


WinHelp Office is a suite of products for WinHelp 
authors. The package includes RoboHELP 3.0, a WinHelp 
video kit, a WinHelp toolkit, the WinHelp HyperViewer, a 
'Mastering WinHelp' video, and a book about moving to 
WinHelp '95. RoboHELP 3.0 is a WinWord add-on that 
automates access to WinHelp features for authors using 
WinWord to create the necessary RTF files. The WinHelp 
Video Kit provides tools to let you integrate video and 
sound into your help system. The WinHelp toolkit pro¬ 
vides a .hip decompiler, a WinHelp inspector that dis¬ 
plays information such as topic titles; a WinHelp 

BugHunter that displays all calls made by a running appli- 

cation to WinHelp; a WinHelp Graphics Locator that al¬ 
lows help authors to search for graphics and other files 
in a specific directory or drive; a WinHelp Graphics Li¬ 
brary that allows authors to select and embed graphical 
bullets, buttons, pictures, and so on; and a WinHelp Style 

Guide. The WinHelp HyperViewer makes it easy to find 
and print specific information in a Windows help system. 

WinHelp Office costs $599. For more information, 
contact Blue Sky Software Corporation, 7486 La Jolla 

Blvd., Suite 3, La Jolla, CA 92037, (800) 677-4946 or 
(619) 459-6365;fax (619) 459-6366. 


Updated File Format Tool Features File Indexing 


Menai Corporation has released Gamelon v2.0, an up¬ 
date to their object-oriented file format tool for C and 

C++ programmers. This version features a file indexing 
structure that supports files as large as 2Gb. The index¬ 
ing feature lets you locate an object in a file via identifi¬ 
ers and jump directly to the referenced object, allowing 
objects to be linked together. The index and the target 
objects can be maintained in separate files or in the 
same file. The product also features object nesting, con- 

cealed offset manipulation, and logical navigation in¬ 
stead of file pointers and file offsets. 

Gamelon v2.0 costs $395 for Windows 3.1; and $495 
for Windows NT and OS/2. For more information, con¬ 
tact Menai Corporation, 1010 El Camino Real, Suite 370, 

Menlo Park, CA 94025-4335, (415) 853-6450; 
fax (415) 853-6453; BBS (415)617-5726; 
info@menai.com. 
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Embedded DOS Now Runs Windows 


Embedded DOS 6-XL is General Software's newest 
embedded operating system. The product can reside in 
ROM and supports features such as power management 
and Windows 3.1 compatibility. It is compatible with MS- 
DOS 5.x and 6.x file systems. Compatible third-party 
products include NetWare, Zinc, Phar Lap, Norton Utili¬ 
ties, and the Brief editor. It also supports M-Systems TFFS 
products providing flash support for embedded systems. 
The operating system provides real-time, preemptive mul¬ 
titasking with 32-bit thread support. It comes with 48 ker¬ 


nel services callable from C or assembly, including 
threads, timers, events, mutex semaphores, and memory 
pools. 

Embedded DOS 6-XL ships in either the Binary Adap¬ 
tation Kit for $995, or the Full Source Adaptation Kit for 
$2,500. For more information, contact General Software 
Inc, 320 108th Ave N.E., Suite 400, Bellevue, WA 98004, 
(800) 850-5755 or (206) 454-5755;fax (206) 454-5744; 
BBS: (206) 454-5894; email: general@gensoftwa.com. 


Apex Creates Object Browser for OLE Apps 


VBA Companion is an object browser that lets you ex¬ 
amine, search, and print programmable objects accessi¬ 
ble from OLE-aware applications such as Microsoft Excel, 
Access, Word, Project, and Visual Basic. The product pre¬ 
sents object properties, methods, events, and help text in 
a format you can tailor. The product supports system- 
wide searches and user annotations, and can produce 
documentation for any OLE control (OCX) or programma¬ 


Accusoft Ships Redlining Toolkit 

AccuSoft is offering a new line of custom-built OEM 
image viewers and front-ends for Windows. The Ac¬ 
cuSoft Image Manager can provide a functional image 
viewer within days. Customers can select and remove 
any combination of features, add personal touches, and 
'private label' the viewer to create custom applications 
with no development work and little time. 

The AccuSoft Redlining Toolkit is a new imaging 
toolkit for redlining and annotation. The product pro¬ 
vides an API for adding redlining and annotation capabili¬ 
ties, and features include lines, arrows, sticky notes, text, 


ble OLE automation object. VBA Companion includes a 
16-bit version for Windows 3.x and a 32-bit version for 
Windows NT, Windows 95, and Win32s. 

VBA Companion costs $79. For more information, 
contact Apex Software Corporation, 4516 Henry Street, 
Pittsburgh, PA 15213-3785, (800) 858-2739 or 
(412) 681 -4343; fax (412) 681 -4384. 


highlighter, hot spots, rectangles, redacting, object link¬ 
ing zooming file I/O, attribute control, and rotation. The 
toolkit is available as a DLL, a VBX, or an OLE control 
(OCX) for Windows, Windows NT, and Windows 95. 

The AccuSoft Redlining Toolkit costs $995 for the 16- 
bit DLL or $1495 for the Windows NT DLL. For more in¬ 
formation, contact AccuSoft, Two Westborough Business 
Park, Westborough, MA 01581, (508) 898-2770; 
fax (508) 898-9662. 


Pipeline 2 Features PC-Host Com With OLE Automation 


Falco Data Products is shipping Pipeline 2, PC-to-Host 
communication software that supports OLE 2 automat¬ 
ion. By writing client programs in VB, Visual C++, or any 
other OLE 2-compatible language. Pipeline 2 users can 
create links from multi-user systems to PC applications. 
These links let users share information, compile informa¬ 
tion from serveral local or remote systems, and replicate 
the information into any OLE 2-compatible program. Us¬ 
ers can convert multi-step remote data retrieval efforts 

Object Manager Connects Repository to 

Object Manager is a new object management tool 
that integrates a variety of tools with a common object 
repository. Object Manager works with Powersoft's Pow¬ 
erBuilder, Visual Basic, SQA's TeamTest, DBMSs from Sy¬ 
base, Oracle, and Informix, and LB MS' Systems Engineer 
client/server CASE product. Object Manager's LAN-based 
repository provides a single control point for managing 
each of the tools involved in developing a client/server 
application. 

With Object Manager, configuration management 
and version control are supported at the object level 


into a single keystroke that can be automatically exe¬ 
cuted at a predetermined time of day. In addition to OLE 
2 automation support. Pipeline 2 contains its own BASIC 
script language, including a macro recorder and editor. 

Pipeline 2 costs $395. For more information, contact 
Falco Data Products, Inc, 440 Potrero Avenue, Sunnyvale, 
CA 94086-4196, (408) 745-7123; fax (408) 745-7860; 
http://www.falco.com. 


rather than the code level. Developers can store objects 
centrally for re-use, giving development team members 
immediate access to the latest design information. Object- 
level security is also provided for developers transferring 
objects between the repository and their workstations. 

Object Manager costs $2,000 per workstation. For 
more information, contact LBMS, Inc, 1800 West Loop 
South, Houston, TX 77027, (800) 231-7515 or 
(713) 623-0414; fax (713) 623-4955. 


VB/PowerBuilder 
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Readers' Forum 


Send letters to wdletter@rdpub.com. 


Sb: Letter a revised magic 
Fm: Mike Dawdy [76275,700] 

I will sum up here my experience with feedback from 
readers regarding my article, ‘Identifying UARTs, Their 
Ports, and IRQs,' April 1995. I heard from about a dozen 
readers of W/DDJ, but 1 wish in particular to acknowledge 
the extensive work done by Andrew Ackard. Magic now 
appears to be completely reliable when run under DOS on 
a non-PS/2 machine. There are three areas that I wish to 
address. 

First, some of the problems encountered were corrected 
when I added back in some code that was in the original 
Magic program, but which I eliminated in an attempt to 
minimize the code size for publication. I erred in thinking 
some of this code was not essential. 

Second, other problems were directly attributable to 
machine and operating system aspects that I overlooked 
when developing the original Magic program. The most 
critical of these have to do with the effects of the second 
8259A PIC in AT class machines. 

Finally, there are still some unresolved issues con¬ 
cerned with running under Windows, and with running on 
IBM PS/2 computers. I am hoping to get feedback from 
readers who have specific technical knowledge in these 
areas. 

The following code items were in the original Magic 
program, were omitted from the published version, and 
have been included in the most recent version (see Table 
of Contents for code availability). Each of these eliminates 
specific problems. 

• A function, sys_config(), written in assembler language, 
which calls interrupt 0x15 to determine if the machine is 
a PS/2; the return value from this function also indi¬ 
cates if there is a second PIC present. 

• If the machine is a PS/2, Magic now checks the six ad¬ 
dresses above 0x3220 which may contain UARTs. 

• Magic now calls uareregisters0 and uart_restore() to 
save and restore the entire state of each UART that it 
finds. 

• uart_init() and uart_reset() are called by uart_irq() to 
initialize and reset the UART; these do a complete in¬ 
itialization/reset process and take into account the 
anomalies of the INS8250-B chip. 

• Interrupts are now disabled during some PIC program¬ 
ming steps. 

• Magic now calls uartJrqO in a loop up to ten times. 
The following code items were overlooked in the origi¬ 
nal Magic program and have been added, in response to 


the experience of readers of W/DDJ. Each of these elimi¬ 
nates specific problems. 

• Magic determines if a second 8259A PIC is present in 
the machine and reports the contents of its ISR and 
IRR. 

• Magic now skips checking addresses used for fixed disk 
and diskette drives. 

• uartJrqO now uses counter-2 of the 8253/4 Program¬ 
mable Interval Timer (PIT) when waiting for the inter¬ 
rupt, instead of the BIOS tick counter. 

• The I0_DELAY macro is now used in a few more places. 

• uart_check() now returns, in an unsigned int, the value 
in the register that failed a test and the test number; 
during debugging, this makes it possible to see why an 
address was determined to be not a UART 

The following are unresolved issues: 

• Under Windows, Magic does not find the port with the 
mouse; the content of the LSR appears as 0xFF which is 
'not possible.' 

• Under Windows, if I eliminate testing the LSR register in 
uart_check(), Magic finds the port but then cannot iden¬ 
tify the IRQ. 

• Under Windows, Magic may report an IRQ incorrectly. 

• What I/O addresses are used for disk on PS/2s? 

• What other specialized I/O addresses are used on 
PS/2s that Magic should not read? 

• There is a difference between PS/2s and PCs, having to 
do with edge sensitive versus level-sensitive interrupts, 
that may be significant; I have not yet explored this 
fully. 

As I mentioned above, I am hoping readers with spe¬ 
cific technical knowledge of Windows and of PS/2s will 
spend some time with Magic and provide me with some 
feedback on the unresolved issues. I can be reached on 
CompuServe at 76275,700. 

Sincerely, 

Mike Dawdy 

Thanks for the revision, which we are including on the code 
disk in the file dawdy.zip (see table of contents for code avail¬ 
ability). -rib 


From: Michael Burr 

<72114.3055@compuserve.com> 

To: wdletter@rdpub.com 

Subject: W/DDJ Vol 6, No. 6 (June 1995) 

In Paul Bonneau's Windows Q & A column in vol. 6, 
no. 6 (June 1995) of the Windows/DOS Developer's Journal, 
he mentions that wavelnPrepareHeaderO uses DPMI function 
0x0600 (Lock Linear Region) instead of GlobalPageLockO to 
pagelock a memory buffer. The suggested reason for this 
is to bypass Global PageLockO's behavior of moving the 
memory block as low in linear memory (often into a 


August 1995 


Windows/DOS Developer’s Journal — Page 81 

























memory address below 1Mb) as possible before actually 
pagelocking it. 

I agree that this is probably the reason for using 
DPMI's Lock Linear Region; however, there are two issues 
that your readers should know about before they choose 
to use this method of pagelocking memory. 

1) Since Windows often satisfies allocations of move- 
able memory from below the 1Mb address space (as 
noted in the "Debugging Fixed Memory" article in the 
same issue), there is a reasonable chance that the mem¬ 
ory being locked will reside under 1 Mb already. Therefore, 
this method will not guarantee that the memory will not 
be locked under 1 Mb. 

2) This method does not ensure that all locked mem¬ 
ory resides in a single area of memory. The rationale for 
GlobalPageLockO rearranging memory before locking it is 
to ensure that there aren't multiple fixed memory blocks 
floating in the address space, resulting in fragmented 
memory. 

It seems that using GlobalDosAllocO to ensure that 
pagelocked segments don't wind up below 1Mb is prob¬ 
ably still the most reliable method to use (if your code can 
afford the expense of the GlobalDosAllocOs). 

Michael Burr 

Good points - thanks! -rib 


From: Gerald Herbel 
<GERALD_HERBEL@novell.com> 

Subject: "Writing Mail-Enabled Applications with MFIS" - 
correction 

I was pleasantly surprised to see the MHS article in the 
April 1995 issue of Windows/DOS Developer's Journal. As a 
senior developer from the Novell MHS team, I would like 
to correct one minor error made in the introductory para¬ 
graph. The statement that NetWare 4.1 includes a copy of 
Basic MHS is not correct - NetWare 4.1 is shipped with a 
'rewritten' version of MHS identified as "MHS Services for 
NetWare 4.1'. MHS Services does support the SMF-71 API 
(as described by Lee). 

MHS Services takes full advantage of NetWare 4.x Di¬ 
rectory Services, which is a X.500-similar replicated, distrib¬ 
uted, hierarchical directory of network resources. The 
same Windows-based NetWare utility (used to setup Users, 
Servers, File System Volumes, and other network re¬ 
sources) handles the creation of MHS mailbox subdirecto¬ 
ries and identification of the NetWare server on which 
these subdirectories exist. All of this simplifies and reduces 
the cost of administration, in addition to providing the ba¬ 
sis of an enterprise-wide address book for e-mail recipi¬ 
ents. 

Keep the practical, down-to-earth articles coming. 

Gerald Herbel 
Novell -San Jose 

Thanks for the correction, -rib 


Sb: 2/95 Bug-H- of the Month 
Fm: Phil Fuhlman [71561,3431] 

I'm kind of torn sending this, but I'm a subscriber to 
the Windows/DOS Developer's Journal and read it with a 
great deal of interest. I think the Bug+-i- column is very 
valuable, but I think you guys need to balance it. I've had 
experiences where people use your column as a weapon 
to promote an agenda (ex., "...we can't use the Borland 
compiler because of this bug here, see...'). I'm particularly 


concerned that you seem to report problems with the Bor¬ 
land compiler, but few with the Microsoft compiler. This is 
especially troublesome when you use a column topic 
highlight on the cover that one could describe as inflam¬ 
matory. I understand that the cover's part of the market¬ 
ing of the magazine, but until you balance the coverage 
(ex., one bug per compiler per month), I think it would be 
better if you'd leave the descriptive one-liner off the cover. 
For example, you could publish this Microsoft bug: 

FILEl.CPP 

//include <windows.h> 

//include <stdio.h> 

//include <file2.h> 

LONG FAR PASCAL WinMainfHINSTANCE, 

HINSTANCE, LPSTR, int ) 

{ 

// put this function in the EXE 

FILE *pf = fopen ( "anyfile.txt", "w+" ); 

if ( 0 == pf ) return 1; 

PassOpenFi 1 ePointerToFunctionlnDLL ( pf ); 
fclose ( pf ); // you’ll never get here 
// because the app will crash... 
return 0: 

} 

FILE2.CPP 

//include <windows.h> 

//include <stdio.h> 

void PassFi1ePointerToFi 1 e2DLL(FILE *pf) 

{ 

// put this function in a DLL 

const int BUFLEN = 128; 

char szbuf[BUFLEN+2]; 

int rc = fgetstszbuf, BUFLEN, pf ); 

MessageBox ( 0, szbuf, "Read", MB_0K ); 

} 

I'll leave the supporting files as an exercise for the reader. 
Compile as a large memory model. This program will 
crash on fgetsO if you build the EXE and DLL with Mi¬ 
crosoft VC++ 1.51 or previous versions and execute it. 
This is a documented feature in the Microsoft Knowledge- 
Base but not in the C library reference manual for fopenO. 
So all I have to do is spend $200 a year to get the Devel¬ 
oper's CD, or have a Cl$ account (or some other access to 
the MS KB). That's nice, isn't it? An ANSI C function that 
doesn't work? But guess what? This problem works fine 
with Borland's compilers, even their 'bug-ridden 4.00 ver¬ 
sion" (as some people like to paint it). 

Here's another one, why does bivbx(102).dll work fine 
with Borland, but not with Microsoft VC++? Oh sure, Matt 
Pietrek's example from MSJ a few months ago will work, 
it's wholly self-contained in one compilation unit. But scale 
it up to multiple modules and it fails miserably. Works fine 
with Borland though. So what if it's a Borland DLL. Win¬ 
dows is a bunch of Microsoft DLLs and both BC and MCVC 
work fine with it. Could be I don't know what I'm doing 
either... 

Here's another one, what's the trick with using call¬ 
backs that route like this: 

EXE --(l)--> DLL --(2)--> EXE 

(1) - Assign function pointer from object a that resides 
wholly in the EXE to object b whose constructor has a 
class member 'do event" function that invokes the func¬ 
tion. 

(2) - Event occurs in the context of object b, so its 'do 
event' function is invoked, which in turn tries to invoke 
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the class member function on object b via the function 
pointer. 

This works fine with Borland, but there's some mysteri¬ 
ous incantation that MSVC 1.50 needs to get it to work. 
Could be I don't know what I'm doing either... 

Here's another one. Build an application. Watch Bor¬ 
land 4.x accept it and let you run it in TurboDebugger, no 
questions asked. Watch VC++ 1.5 blow with a GP fault in 
CVPACK. Call Microsoft, be treated like a child. Have the 
guy then tell you that he thought that one was fixed. . . 
So the MsDude tells you to just disable debugging on a 
module by module basis (sounds like BC3.1). Hey MsDude, 
how do I do that in your IDE? MsDude responds, I know 
you can do it, I just don't remember how to do it.. . Sure, 
handjob the makefile we're not supposed to edit, yeah 
that's the ticket.. . 

I'm not trying to flame you guys, I like the magazine 
and I think the Bug++ column serves a valuable purpose, 
but you need to balance the coverage across the compil¬ 
ers. Otherwise we are going to quickly end up with a situ¬ 
ation where people think the Borland compiler is bug-rid¬ 


den, and MSVC is perfect. Of course, I am assuming that's 
not your agenda. Borland sales will suffer, and they'll 
either end up as a boutique compiler or drop out of busi¬ 
ness completely. I for one don't relish buying version 5.0 
of the Borland compiler compliments of CA. BC is still eas¬ 
ier to use than MSVC, and MSFT has really ripped us¬ 
ers/developers by dropping support of the 16-bit unit. Of 
course, maybe I'm just jealous because I'm one of the un¬ 
cool that don't have a copy of Windows 95 and a job 
where we've blown off all of our Win3.x users .. . 

Sincerely, 

Phil Fuhlman 

Showing favoritism (or in this case , less negativism) toward 
any particular vendor is something we hope to avoid. When I 
first read your letter, I thought perhaps we had run three Bor¬ 
land bugs in a row. In fact, I went back and checked and it turns 
out that we have run exactly as many Borland bugs as Mi¬ 
crosoft bugs in Mark's column. That's not entirely by accident, 
though. As the column was taking shape, we decided that the 



Developer's 

Marketplace 


S/W ENGINEERING POSITIONS NATIONWIDE 



We Understand 
Programmer’s 


Mind. 


When the country's 
top firms look for 
the best develop¬ 
ers available, they 
turn to Bateman. 
Why? Because we 
specialize in MS 
Windows, NT, OS/ 
2 and Macintosh re¬ 
cruiting nationwide. 
So if it's time for a 
career move, give 
us a call. We un¬ 
derstand your 
skills, and the mar¬ 
ketplace for them... 
we understand you. 


8 Bateman Inc. 


5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax:310-641-2900 
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Add ZIP (and UNZIP too!) to 
your Windows applications! 


.DynaZIP 30 

| Data Compression Toolkits 


The new ROYALTY-FREE DynaZIP family of 
developer's tools let you add ZIP and 
UNZIP capabilities to your Windows 
applications. No more "shelling" to 
DOS, no more fussing with proprietary 
compression formats. DLLs, VBXs, OCXs 
and a new database interface provide 
full access from many languages. Fast, 
reliable, and easy to use! 16 and 32 
bit versions, supports long filenames. 


Fully Supported, 
w/30-day no-risk guarantee! 
Call today, toll free: (800) 962-2949 


Inner Media, Inc., Hollis NH USA (603) 465-3216, fax (603) 465-7195 
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Visual Basic 

TRAINING VIDEOS 

Presented by J. D. Evans, Jr. 

Fundamentals of Visual Basic #1 

is Ihe first video in the seres, Topics include on introduction to VB, a history 
ot VB, diagramming techniques, programmer's ■ responsible!, and user 
interlace design. (90 min.) 

Fundamentals of Visual Basic #2 

topics include naming conventions, the event model, code practices, 
structuring code, and diagramming techniques. Spac'd attention is 
given to event model programming. (90 min.) 

Each video is $129. 

Get both videos for $199. 

Plus S&H. PA Residents add Sales Tax. 

30-Day Moneyback Guarantee. 

ETN CORPORATION 

RR4 Box 659 

MONTOURSVILLE, PA 17754-9433 
Tel: (717)435-2202 Fax: (717)435-2802 
CompuServe: 73641,242 
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Prolndex" 



Full-Text Indexing and Retrieval 



Development Toolkit! 



• Perfect for CD-ROM applications and 



dynamic data management 



• Unequaled indexing speed! 



• Fast complex searches 



• Handles wildcards, phrases, proximity and more! 



• Use with C/C+ + , VB, Delphi, etc. 



• LAN and multi-user support 



• DOS, Windows, Windows NT, Windows 95, 


1 

OS/2, NeXT, Unix, and Macintosh 

Call today for a FREE demo and information! 

InfoSphere 

801-221-5902 

RO Box 225, Pleoionl Grove. UT 84062 
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Lexicus Longhand 

Handwriting Recognition Software 
Windows Developer Version 


Lexicus Longhand 
recognizes 

your cursive 
^nvAMAMyuJlr^. 
handwriting. 


Software software 
Softened softened 
Solitude solitude 
Softener softener 
Sentence sentence 
Soft/oare soft/oare 


L&.o.f.lK.aj 

■r.e x . . . , 

I..."*...! 


1 recognizes cursive, print and mixed styles 
• dictionary building tool included 

1-800-LEXICUS or 415-462-6800 

internet: info@lexicus.mot.com 
url: http://www.mot.com/lexicus/ 
Lexicus, A Division of Motorola 




MOTOROLA 
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Development 

CD-ROMs 


Absolutely the world's largest, best indexed and 
most current collections of technical shareware 
CD-ROMs for professional programmers since 
1984. Priced from $25. Database (DBF) directories 
describe all products on CDs in detail, and include 
information on all commercial tools as well. Up¬ 
dated at least every two months. 

We have CD-ROMs with 684 MS-Access prod¬ 
ucts, 678 Assembler files, 2059 C/C++ files, 1000 
C++ only, 1348 AutoCAD, 3204 Clipper, 2250 
FoxPro, 2305 NetWare Utils, 809 OS/2 Utils, 527 
Spreadsheet Utils, 1075 Paradox, 1289 Pascal, 537 
Scientific, 305 VBDOS/QB/PDS, 1350 Visual Ba¬ 
sic, 1000 Windows Utils. Also Clarion and Delphi. 
All include 215,000 record database of PC prod¬ 
ucts in DBF and Windows HLP formats. 

EMS Professional Shareware 
4505 Buckhurst Ct.; Olney, MD 20832 
Voice:(30l}924-3594 Fax:(301)963-2708 
EMail :ems@wdn.com 
http://www.xmission.com/~wwwads/ems 


Don’t gamble with your 
job search. 

Use DICE. 


DICE is looking for Data Processing, Engineering and 
Technical Writing professionals to fill open positions 
for companies nationwide. 

DICE is a FREE online job search service, providing 
detailed information about current contract and fulltime 
positions across the USA. Please contact by calling ANY of 
these access numbers, using your computer & 1200-9600 
baud Modem, 8-N-l. 


California. 

Georgia 

Illinois 

Iowa 

Massachusetts 
New Jersey 
Texas 
Internet 


408-737-9339 
404-523-1341 
708-782-0960 
515-280-3423 
617-266-1080 
201-242-4166 
214-691-3420 
telnet dice.com 


Data processing 

I NDEPENDENT 

Consultants (j 

E XCHANGE , 

A Service of D&L Online, Inc.: (515) 280-1144 


Phone Sound: Simple! 

For Windows/DOS Voice Mail & Fax Developers 



1. Create fantastic prompts 
and save time with VFEdit®'. 
Record, crop, cut, copy, paste, 
mix, fade, echo, volume & 
more with your Dialogic™ 
D4x/12x boards. 

2. Add Voice Mail power to 
your MS Windows apps with 
TI/FDLL ™, our Tel I/F 
Dynamic Link Library. 

3. Scribe plays digital audio 
files without voice hardware! 


Professional 
Tools for 
your Voice 
Mail, Fax & 
Audiotex 
Applications 


4. Add Text-to-Speech 
capability with VoxFonts™, 
our text-to-speech library! 

5. Audio Tool Box™ 
converts between Multimedia 
Wave (16, 8 & MS ADPCM), 
unsigned 8, linear 16, CCITT 
G.711/G.722, Dialogic 4/8 & 
more! Batch convert, crop, 
chop, normalize & filter. Add 
conversion to your apps with 
our ToolBox SDK'. 


ZSZ Order Now! 800-234-VISI 


VISI, 2118 Wilshire Blvd, #973, Santa Monica, Ca 90403; 310-392-8780 
Fax: 800-234-FXIT / BBS: 310-392-6610 (Download our Working Demos) 
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Windows hardware access... 


WinStar Hardware Classes IU 

C++ classes and C API for hardware 
access from Win32 applications. 

♦ Port and physical memory access 

♦ Support for interrupt handlers 

♦ Hardware Viewer utility included 

♦ Supports Windows 95 and NT 

♦ No DDK required 


For NT DDK development... 


Device Talk,„ 

Single-machine debugging tool for NT 
device driver development. Trace, 
breakpoint, and device extension 
symbolic viewing support. 



WinStar Technologies IM 
(415) 647-2815 
CompuServe: 74367,1773 
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Opt-Tech Sort/Merge 


New - Version 5 

High performance Sort/Merge/Select 
utility. Run as a stand alone 
utility or CALL as a subroutine. 

Supports most languages and 
filetypes including Btrieve 
and dBase. Unlimited filesizes 
multiple keys and much more. 

MS-DOS, Windows $149 
OS/2, UNIX $249 

Call to order or for free info. 


Opt-Tech Data Processing 

P.O. Box 678 
Zephyr Cove, NV 89448 

. (702) 588-3737 > 
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I Does your company 

provide tools, products, 
or services for advanced 
Windows programmers? 
Then reach over 22,000 
serious programmers in: 

Windows/POS 

□ DEVELOPER'S JOURNAL 

Call 913-841-1631 today for 
information about 
advertising opportunities in 
Windows/DOS Developer's Journal. 

Advanced. Serious. 
Technical. 


I Brian 

Osborn - Continental Europe. 

1+49 431-801740 


I Ed - East 

I Christine - Midwest 


1913-841-1622 

1913-841-6733 

1913-841-1626 



Free CDROM! 


Sampler CDROM: You get useful samolesfiwj 
44 CDROMs + S5.00 check inside-1 J :lt H 


"Free with regular $5.00 shipping charge _ 

Cita MS Windows: 2-disc set! 4000 new $29.95* 
prgrms, gomes, utilities, drivers, code, fonts. 

Simtel MSD0S: Now 2-disc set! 1000 MB $34.95* 
MSDOS shareware (utils, games, code, etc.) 

Hobbes OS/2: OS/2 Mag's Product of the Year! $29.95* 
600 MB of OS/2 Shorg/freewore (2-disc set). 

C Users' Group Library: C Users'Journal $49.95* 
Archive: 10 yrs of C code 8, articles 
Source Code : 650 MB C, Usenet Unix, DOS $39.95 
Toolkit for Linux: Slackware 2.0 32-bit 0/S $39.95 
for PC with GNU & XI 1. Src. (2-disc set!) 

FreeBSD 2.0: Berkeley BSD, 32-bit 0/S for $39.95 
PC, with GNU &Xll. Full source. 

Internet Info: 12,000 computer, network $39.95 
Internet documents. FAQ's, RFC's & lEN's 
Space & Astronomy: Thousands of NASA $39.95 
images + viewer, 5000 data files, prgrms. 


•shareware requires separate payment to authors if found useful 

Coll Now lor our Free Catalog! 1 -800-7 86-9907 

Walnut Creek CDROMIH ESM 

1-510-674-0783 - FAX 1-510-674-082 lHjj 
email: orders@cdrom.com LEE 

4041 Pike Lane, Suite D-692 Concord, CA 94520 
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ABSOLUTELY, 
POSITIVELY, 
NO MORE 
Vl»T|%%0 

e r r or s / 


$5/disk, 

one issue per disk 
or ALL of 1994 
or 1993 for $20! 

Call today! 

913 - 841-1631 

FAX 913-841-2624 


Windows/DOS 


□ DEVELOPER'S JOURNAL 

Suite 200 

1601 West 23rd Street 
Lawrence, KS 66046 


MGSpell V2.0 

120,000 wprd dictionary 
Spell Checking/Corrections 
User Dictionaries 
WIN/DOS and Mac Versions 
Use Win version with any DLL compat language 
DOS Version works with C/C++ 

MGSPELL V2.0, Item 11359, $99 

Display-Gif 

Add FULL-Color GIF Display/Import 
Great For Title/Info Screens 
Uses ONLY BGI Function Calls 
Includes SuperVGA(VESAJ BGI Driver 
For use with Borland C/C++ only.full source code 

VIEW-GIF, Item 11450, $50 

To order call PSL: 

1-800-242-4775 (713-524-6394) 

Order by item number, this 
number is for orders only. 

For more info contact: 

1-800-270-1394 (314-638-2506) 

76476.1701@compuserve.com 
MicroGenesis Software,P.O. Box 25534 
St. Louis, MO 63125 
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bug coverage should roughly reflect the percentage of our read¬ 
ers that use each compiler. That means that Borland should 
show up about half the time, Microsoft should show up about 
half the time, and Symantec and Watcom should show up per¬ 
haps once a year. After reading your comments, I now realize 
that one could construe this to mean that Watcom and Syman¬ 
tec are nearly bug-free, which is not what we mean to imply at 
all! 

As I've said before in this magazine, I surely hope that Bor¬ 
land C++ does not go away. It is clear to me that Microsoft's 
compiler did not begin to get competitive until Borland C++ 
was stealing large amounts of market share from them. If Bor¬ 
land goes away, I expect Microsoft's compiler will drift into com¬ 
placency again unless and until there is serious competition. 
When Borland botched their 4.0 release, I took no joy in report¬ 
ing it here, but there was really no choice. It's simply not our 
role to help save Borland or any other vendor, and I certainly 
don't avoid criticizing Microsoft snafus, such as their amazing 
plan to make programmers pay big bucks if they want to re¬ 
ceive Visual C++ bugfixes. 


Your comment about programmers using things like our bug 
coverage to beat up on Borland is very interesting. I don't think 
we can fix that, since anyone determined to use a copy machine 
to excerpt a particular slant from our magazine will find some 
way to do it, unless every sentence ends with "But Microsoft has 
bugs too!" I do sense an increase in the number of program¬ 
mers who are rabidly for or against one compiler or another, 
but I don't entirely understand that trend. Borland, Microsoft, 
Watcom, and Symantec all have quite decent compilers (does 
anyone remember the initial C compilers available for the PC?), 
each with different strengths and weaknesses. But let me say for 
the record that all four compilers have a great many bugs (lack 
of material for Mark's column is not projected to be a problem) 
and I have so far seen no reason to believe that any of them 
has significantly fewer bugs than the others. 

Thank you for going ahead and sending this letter to me. 
Editorial balance is one of those things I get paid to think about, 
and readers like you help keep me sensitive to these issues, -rib 
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HASSLE-FREE 

HARDWARE 

CONTROL 



REAL TIME TOOLKIT FOR WIN32® 
WindowsJ95 <i6ulg"66D - E -»NT. 


Spend your time writing your App... not wading through D.D.K. documentation! 
Fast hardware control under Win32 ? without the DEVICE DRIVBIKITI 

V PORT I/O V MEMORY I/O V INTERUPTS 

Also available on: Alpha™, PowerPC™, MIPS™ versions. 



• Visa, MC, Approved P.O.* Windowa.95 Version 
735R132@COMPUSERVE.COM 



OFFICE (206) 771-3610 FAX (206) 771-2742 
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Diskette I/O 

Code Libraries 
Device Drivers 

VxDS 

Special Hardware 


Software for Conversion, 
Duplication, Analysis, 
and Data Recovery 


WE SPECIALIZE IN "ALIEN" 
NON-PC FORMATS. 

Write or call for a product brochure! 

WV7A|PY PO Box 5700 
▼ VJ-VlA. Eugene, OR 97405 

(800) 43-SYDEX or (503) 683-6033 
FAX (503) 683-1622 

□ Request Fax #1087 □ 


Developer Jobs! 

Internet: ngi@scientific.com 

Commercial software developers should con¬ 
sider registering with Scientific Placement. 
R&Djobs for software engineers, SQA, prod¬ 
uct managers, etc. Nationwide contacts with 
both large and small companies including 
start-ups. Many clients develop commercial 
software products. Most develop for Win¬ 
dows, NT, Macintosh, OS/2, and Unix based 
platforms. We also recruit in other leading 
edge technology areas such as PDA, low level 
and real-time, compilers, etc. Managed by 
graduate engineers. Send resume or call for a 
marketability assessment. Never a fee. 

Scientific Placement, Inc. 

800-231-5920 Fax 800-757-9003 

CompuServe: 71250,3001 AOL:davesmall 
SPI8, Box 19949, Houston, TX 77224 
713-496-6100 Fax:713-496-0373 
SPI8, Box 71, San Ramon. CA 94583 
510-733-6168 Beth@spica.bdt.com 
SPI8, Kenmore Station. Box 15225 
Boston, MA 02215 617-424-8372 jen@spbos.pn.com 
SPI8, P. O. Box 202676, Austin. TX 78720-2676 
512-918-3785 lej@zilicer.net 

V___ 
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WE WANT TO PUBLISH 


a 



Jim 


We are looking for Windows™ 
programs and utilities that appeal to the 
typical PC user. Our marketing 
expertise in the retail channel, winning 
track record and your software can 
create another software industry 
winner! All calls are confidential and 
your ideas will be protected. 

AllMicro, Inc. 

Call (8001653-4933 wi 
ask for Chip Payson 
Fax (813) 531-0200 
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VB Tech Journal says... "I found ProEssentials 
both professional and essential. It s a first- 
class product." 

GigaSoft™ 
ProEssentials™ vl .5 



Weekly Defectt Report 


For... 

Visual Basic, 
VC++, BC++, 

. Delphi, Gupta, 
j PowerBuilder, 
" Clarion, 
FoxPro, 
dBaseWin, 
and others. 


Windows 3.1 DLL/VBX/FLL providing three interactive 
controls: Graph, Scientific Graph, and Pie Chart objects. 
Ideal for information-system, financial, scientific, quality- 
control and data-acquisition implementations. User 
dialogs and popup menus, graph plus table, revolving 


subsets / panning points, smooth real-time, no 
overlapping labels, help, maximization, extensive export 
capabilities, comprehensive hot-spots, zooming, null- 
data, and quick / easy to implement. Call for a free demo 
or download pedemo.zip’ from CIS’s VBPJFO forum. 

’ST $249 

(ligasoft. Inc. 817-431-8470 fax: 817-4.11-9860 
□ Request Reader Service #279 □ 
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Our editor has speed, 
a complete macro language, 
configurability, large file handling, 
compiler automation, and 
colorization. Cost? $89.95 for 
Windows, $129.95 for Windows 
NT. See for yourself. Download a 
demo copy. 

Try a complete, free evil copy tonight! 

BBS: 206-935-5198 
AOL: WindowWare 
CompuServe: WINAPA, Sec. 15 
FTP: www.windowware.com /wwwftp/wilson 
WEB: http://www.windowware.com/wilson/pages/ 
Orders: 1-800-938-4599 
Wilson WindowWare, Inc. 
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The best embeddable 
macro language... 


• is completely compatible with Visual Basic, 

offers such VBA features as keyword 
parameters and With statement. 

• supports full OLE 2.0 automation. 

■ • provides direct 

^ I access to C++ objects; 

% I supports polymorphism 

wJ mm and smgle inheritance. 

• is application-extensible through functions, 
objects, data types, variables, and constants. 

• includes an Editor/Debugger, an integrated 
Dialog Box Editor, printed and on-line Basic 
documentation - all redistributable to end users. 

• The Editor/Debugger offers breakpoints; step 
into, step out of, step over; watchpoints; 
structures; arrays; expand/contract. 

—i The Dialog Box Editor features drag 
and drop, multiple selection. 


-800-298-3500 


Mystic River Software, Inc. 
info@mysticriver.com • Fax (617) 864-7747 

• •••••••••••• 
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The Fastest XBASE Engine 

CodeBase provides C, C++, Visual 
Basic and Delphi programmers 
with the fastest XBASE compatible 
database engine. Get multi-user 
compatibility with FoxPro, Clipper 
and dBASE files. And it's portable 
from DOS to Windows to UNIX! 
FREE 30 day trial 

Included are data aware controls for 
Windows, a powerful report writer 
and the entire set of source code! 
All the popular C/C++ compilers are 
supported. Scale from single user 
to client/server without any source 
code changes. 

Royalty Free distribution. 

Call Sequiter Software Inc. for details! 
Phone: 403 437 2410 FAX: 403 436 2999 
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IMWHelp 


UJindouj/ Help Authoring Tool 


Professional quality help files 
in 1/4 the time!! 

• Edit text directly in IMWHelp 

• Build hypertext links to: topics, 
definitions, subjects 

• Glossary automatically created 

• Bitmaps incorporated 

• Desktop publishing features 

• Print topics, help file, customized 
reports 

• Spell check, replace verify/all 

• Easily reorganize topics, subjects, 
keywords 

• Uses Microsoft Help Compiler 

Single User: $89.95 

MC & Visa accepted, Shipping additional 

Call: IMCSI (212)319-1903 

425 Madison Ave., New York, NY 10017 
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Unique Custom Controls 

We've got the controls everyone else 
missed. Whybuyyetanotherpackage 
with a bound text box when you can 
get more? 

Our controls are easy-to-use, solid, 
and royalty-free. Free lifetime updates 
from our BBS. Source code and site 
licenses are available upon request. 

There are too many to mention here, 
so write, call, or fax us for a product 
list. Or, send us $5 for a sample disk. 

Mabry Software 

Post Office Box 31926 
Seattle, WA 98103-6925 

Voice: 206-634-1443 
Fax: 206-632-0272 
CompuServe: 71 231,2066 
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Costs just $75 per LAN! 


* Connect via Ethernet, Arcnet, 

* via serial, parallel, or modem 

* Low memory use - about 50k 

* Dos 6, and Windows compatible 

* Link up to 250 nodes, still $75 

* Share almost anything 

* Netbios and file/record locking 

* Version 2.0b 

Skeptical? We make believers! 

Information Modes 
P.O. Drawer F 
Denton, TX 76202 
817-382-7407 Fax 

1-800-628-7992 
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C and C++ DOCUMENTATION 


!! NEW VERSION 6.0 !! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

• C-METRIC ($59)Counts path complexity, 
counts comments, code, 'C' statements. 

• C-LIST ($69) Lists and action-diagrams, 
or reformats into standard formats. 

• C-REF ($69) Creates cross-reference of 
local/global/define/parameter identifiers. 

. C-DOC ($199) PACKAGE All 5 programs 
integrated as DOS program (<10,000 lines) 
V6.0 C-BROWSE Windows graphic-tree viewer. 

. C-DOC Professional ($299) DOS, Windows 
OS/2. 3-ring binder/case. <1,000,000 lines 

• 30 -DAY Money-back guarantee CALL NOW 

SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga „ 

0NT, Canada Voice/Fax (9051-858-446 6 
L$tMM^^Demo/BBS(9Mg58T9jF 
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WINDOWS DEVELOPERS 

As a headhunter focusing on one area of 
software engineering, I believe I can find you 
the best opportunities. Through constant 
networking I learn of positions all over the 
country. All fees are paid by the client 
company. The market is excellent for talented 
windows developers. Give me a call at 
1-800-638-8903. (CompuServe 73172,663) 
— Gary Patton 
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Prepare for the Lotus Notes 
Certification Tests. 


Lotus Development and Drake 
International charge $270-$450 to 
get certified on Lotus Notes. Isn’t 
it worth $45-$60 to prepare? 


Consultant, 
Application Developer, 
Server Administrator PreTests 
(over 480 questions) 
cost just $45 each 
or buy the Specialist PreTest 
(over 720 questions) for just $60. 

These Lotus Notes databases allow 
you to take and grade the Pre Tests as 
many times as you want or need to. 


Send check or money order to: 

Reality Bytes 

28 South Main Street 
Randolph, MA 02368 
(Please share this ad with a friend.) 
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Sb: Win32 version of About 
Fm: Nick Payne [100033,432] 

Ron, 

For the last couple of years I have been using Paul 
Bonneau's About box routine, which was published in 
your magazine. I recently wanted to use it in a Win32 
program and found that the code needed a few trivial 
changes to run under Win32. Fiere is the Win32 version 
of the code if you would like to make it available to your 
readers. The interface is unchanged. 

Nick 

Thanks for the update, which we have placed on this 
month's code disk as about.zip (see table of contents for code 
availability), -rib 


To: ronb@rdpub.com 

From: Mike Schoenborn <mjs@hcd.com> 

Subject: W/DDJ Online Index 
Ron - 

What happened to that great resource, the W/DDJ On¬ 
line Index, wddj.hlp ? The most recent I can find (on the ftp 
site) covers issues through 9/93. Will it eventually be up¬ 
dated, or is there an alternate online index to W/DDJ ? 

Thanks, 

Mike 

It was a nice idea, but it was a personal project on my part 
and I eventually could no longer afford the time required to 
keep it up. The only good news I can offer is that we may be 
able to eventually offer the entire contents of the magazine on 
CD-ROM. I'm keeping my fingers crossed, as I have often wished 
for the ability to do a full-text search to locate a piece of infor¬ 
mation I knew was buried somewhere in all those back issues, 
-riba 



Developer's 

Marketplace 


Ever wish you never had to worry 
about your data? 


DATAFAST 1.0 for Win32 


A full featured database engine for Windows NT and 
Windows 95. Ideally suited for any type of application 
which requires fast access to data. 

* C API or C++ Class Library 

* Unlimited Records and Fields 

* Extensive Searching/Sorting 

* 32 bit speed 

* DLL or static libraries 

* Less than 48k 


Call, write or email for a 
free trial diskette. 



Too & Frankie's Amazing 
Software 

15 Central Way, #48 
Kirkland, Wa. 98033 
TFAS@OZ.NET/(206)861 -9086 

DATAFAST is a trademark of Too & Frankie's Amazing Software. All other 
trademarks are owned by their respective owners. 
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Spy on any Windows Program! 


API Vision 



Total detail display for 2000+ APIs in 36 
categories, including base APIs, drivers, 
multimedia, networking, OLE, winsock, 
undoes and more.- 

“Insanely Great” $199+$sshi P 

Software Development Magazine guJSte 
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Berkeley loolworks Berkeley ,ca 94710 
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NOW IN EUROPE 


FOR ALL EUROPEAN SOFTWARE VENDORS 

In order to sen/e our European advertising 
customers better, Windows/DOS Developer’s 
Journal now has a European Advertising 
Representative located in Germany. 

Now it is even easier tor you to reach over 
22,000 experienced Windows programmers 
worldwide with an advertisement in 
Windows/DOS Developer's Journal. (U.K. 
customers: please call Ed at 
01-913-841-1622.) 

Windows/DOS 

□ DEVELOPER'S JOURNAL 

Advanced. Serious. Technical. 

Brian Osborn 

breakout! marketing 
Duevelsbeker Weg 4 
24105 Kiel 
Germany 

Phone: +49 431 801740 
FAX: +49 431 801797 
email: 100332.1704@compuserve.com 


Wouldn’t it be nice to make your 
product known around the world? 



Interactive Help For Windows 


Transform WinHelp from a 
passive display viewer to an 

INTERACTIVE APPLICATION DRIVER! 


IH - the new WinHelp DLL extension language is 
the perfect tool for WinHelp interactive applications. 

Use IH to: 

• Design and process forms & dialogs using option lists, 
edit boxes, input validation, etc. 

• Create dynamic help topics using dynamic text fields 

• Embed video clips in WinHelp topics and activate them 
from your procedures 

• Connect to external databases using a dynamic 
dispatch function mechanism 

• Trap and handle WinHelp events using a structured language 

• Expose and use the WinHelp internal extension functions 

• Activate macros automatically upon topic entry and exit. 

Get Interactive Help for Windows 
for $149 ! 

lyperAc 

Inc| ^ 


P.O.Box 5517. Coralville. IA 52241. USA. 
TeleFax. (319)351-8413. CompuServe 76350.333 
Internet: rhalevi@hyperact.com 
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Dr. 

ODBC Tools 

Tools for ODBC development 



Ever wonder why 
your ODBC app is not 
working? Why it’s just 
too slow? If the ODBC 
driver is OK? 

Dr. DeeBee utilities reveal the inner workings of ODBC. 


Call for a Free ODBC prescription! 


w 

snv/iffE 


Conned proprietary databases to 
Access. Visual Basic, and PowerBuilder 
with our Dr. DeeBee ODBC Driver Kit 


RO. Box 91 Kendall, Cambridge, MA 02142 

G17-497-1376 Fax 617-497-8729 
http://www.syware.com/drdeebee/ 
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The Ultimate High Performance Imaging Toolkit! 


PERFORMANCE 



QUALITY 


AccuSoft Image^ormat Library 5.0 


Ultimate Imaging Toolkit 

AccuSoft provides the ultimate 
imaging toolkit solution with the best 
performance, most formats, most 
platforms, best pricing and most 
complete API. Which is why we are 
the leader and why over 5000 
companies have chosen AccuSoft for 
their imaging needs! 

Performance 

AccuSoft has always been known as 
the performance leader. We know 
that you want the fastest imaging 
possible and that fast is never fast 
enough. Therefore, we constantly 
work on improving performance to 
keep us (and you) ahead of the 
competition. 

Quality 

AccuSoft has become the leader in 
imaging toolkits due to our untiring 
commitment to quality. Not just 
product quality, which can be seen in 
our unique guarantees, but also 
service quality with our special fast 
delivery program to our top rated 
technical support and rock-solid 
technology. 

Call us today at (800)525-3577 


Pro Gold 

The Pro Gold versions of our 
imaging toolkits are unbeatable for 
performance and special features like 
scale to gray, sub-degree rotation, 
sub-second decompress & display, 
sub second screen rotation, huge 
image handling and more. If you 
want the best performance available 
anywhere at any price, this is it. 

Cross Platform 

Wouldn't it be nice if you could sell 
your applications on many different 
platforms without having to recode 
the imaging portion? AccuSoft's 
cross platform design is tailored for 
easy porting and since we support 
ALL platforms your products can be 
sold to every market. 

Image Guarantee 

When your image is on the line - 
choose AccuSoft. We guarantee your 
image, in fact we guarantee all your 
images. Our AccuSoft Image 
Guarantee™ has been in effect for 
over four years and states that we 
guarantee to read ANY raster image 
in all 36 formats we support. Not just 


parts of each format, but any type or 
flavor or sub-flavor or sub-format. 
This guarantee means you get the 
highest quality imaging toolkit 
available. 

VBX, OCX or DLL 

AccuSoft has a complete line of 
Visual Basic custom controls that will 
work with VB, PowerBuilder, SQL 
Windows, Delphi, Visual C, and any 
other VBX compatible host 
environment. We also have OCX 
versions for VB 4.0, MS Access and 
more. The VBX and OCX versions 
have over 150 properties and events, 
and are fully interactive. These are 
the most powerful and easy to use 
controls on the market. DLL 
versions with comprehensive & high 
level API's are available also. 

Order Today 

Call today and you can start writing 
high performance imaging 
applications in less than one hour 
with our unique 30 minute delivery 
program! 

AccuSoft 

High Performance Imaging' 


Platforms 

Supported 

Windows 
Windows 95 
DOS 


NT 
OS/2 
FoxPro 
SUN OS 
SUN Solaris 
HPUX 
RS/6000 


SCO 

MAC 

PowerMac 


36 File Formats 
Supported 






Two Westborough Business Park Westborough, MA 01581 Tel (508) 898-2770 FAX (508) 898-9662 


ACCUSOFT 

IMAGE 

GUARANTEE M 


Look for the 
AccuSoft Image 
Guarantee™ 
or the AccuSoft 
trademark on your 
favorite software 
products as a 
statement of 
superior quality. 


©1995 AccuSoft Corporation. All Rights Reserved. All company and brand names are trademarks or registered trademarks of their respective owners. 
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Windows 95: See It All 
With Nu-Mega's Soft-ICE! 


Your 32-bit Application 
Debugger Is Stuck In The Win32 
Subsystem, But The Bugs Aren't! 

When chasing a tough bug through the 
multiple layers of Windows 95, you need a 
debugger that can easily follow it. You need 
visibility and debugging power to chase 
bugs anywhere they go. When your con¬ 
ventional application debugger falls short, 
your only option is Soft-ICE/WIN 95. 

System crash bugs are particularly frus¬ 
trating without the right tool. Without visi¬ 
bility and control, these can take days, or 
even weeks to solve. Soft-ICE/WIN 95 
gives you visibility with it's internal system 
commands. It can show you what led up to 
the crash with its back trace history capa¬ 
bility. Soft-ICE/WIN 95 also gives you real 
control because it can debug through any 
code in any part of Windows 95. 

Soft-ICE/WIN 95 sits right on the metal. It 
is not dependent on any system code. Its In- 
Circuit-Emulator (ICE)-like features let you 
debug any Windows 95 code without side 
effects, and without expensive hardware. 

Windows 95 Is Here And 
It Means Change. 

Soft-ICE/WIN 95 understands all of the 
subsystems that make up Windows 95. It dis¬ 
plays relevant information in each subsystem 
and gives you a bearing when you find your¬ 
self in a part of Windows 95 that you never 
expected to end up in. 

Whether you want to dig in and learn 
Windows 95 inside out, or you want to 
be prepared for the nastiest Windows 
bugs, make Soft-ICE/WIN 95 a part of 
your tool kit. 


p Nu-Mega 

% TECHNOLOGIES INC 


4GB 


WINDOWS 95 


VxDS 

Dynamic VxDs 


3GB 


2GB 


32-bit 

System DLLs 

/ 

16-bitt 


Windows 


Applications 

3Js 



4MB 



Soft-ICE/WIN 95 is the 
Only debugger that lets 
you debug VxDs at 
source level. 


You often have to step into 
the Windows 95 system DLLs 
to chase nasty bugs. When 
you do, make sure you have 
Soft-ICE/WIN 95 because your 
application debugger won't do. 


If you are chasing a bug that 
involves 16-bit and 32-bit code, 
Soft-ICE/WIN 95 will get you 
through the thunks at source level. 
Other debuggers can't. 


Your 32-bit application 
debugger leaves you 
trapped here. 


Soft-ICE/WIN 95 lets you 
switch address contexts so 
you can debug multiple 32-bit 
applications simultaneously. 


Some of the most difficult bugs 
are the result of real mode 
programs, T&SRs or drivers. 
Soft-ICE/WIN 95 can debug 
these, as well as everything 
else in Windows 95. 


Windows 95: See It All! 

Get Soft-ICE/WIN 95 

Call 1-800-4-NU-MEGA 

(1-800-468-6342) 

RISK = NULL 30 DAY MONEY BACK GUARANTEE 


ONLY 

$386! 

PLUS SHIPPING 


102 Perimeter Road Nashua, NH 03063 (603) 889-2386 Fax (603) 889-1135 i n f o@ n u m eg a . co r 
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